CodeDeploy AppSpec referensi file

Bagian ini hanya referensi. Untuk ikhtisar konseptual AppSpec file, lihatApplication Specification Files.

File spesifikasi aplikasi (file) adalah AppSpec file berformat YAMB atau berformat JSON yang digunakan oleh untuk mengelola penyebaran. CodeDeploy

catatan

AppSpec File untuk penerapan EC2/On-premise harus diberi namaappspec.yml, kecuali jika Anda melakukan penerapan lokal. Untuk informasi selengkapnya, lihat Buat penerapan lokal.

Topik

• AppSpec file pada platform komputasi Amazon ECS
• AppSpec file pada platform AWS Lambda komputasi
• AppSpec file pada platform komputasi EC2/lokal
• AppSpec Struktur file
• AppSpec Contoh file
• AppSpec Spasi file
• Validasi AppSpec File dan lokasi file Anda

AppSpec file pada platform komputasi Amazon ECS

Untuk aplikasi platform komputasi Amazon ECS, AppSpec file tersebut digunakan CodeDeploy untuk menentukan:

• File definisi tugas Amazon ECS Anda. Ini ditentukan dengan ARN dalam TaskDefinition instruksi dalam file. AppSpec

• Container dan port dalam tugas pengganti Anda ditetapkan di mana Application Load Balancer atau Network Load Balancer mengalihkan lalu lintas selama penerapan. Ini ditentukan dengan LoadBalancerInfo instruksi dalam AppSpec file.

• Informasi opsional tentang layanan Amazon ECS Anda, seperti versi platform yang dijalankannya, subnetnya, dan grup keamanannya.

• Fungsi Lambda opsional untuk dijalankan selama pengait yang sesuai dengan peristiwa siklus hidup selama penerapan Amazon ECS. Untuk informasi selengkapnya, lihat AppSpec Bagian 'kait' untuk penerapan Amazon ECS.

AppSpec file pada platform AWS Lambda komputasi

Untuk aplikasi platform komputasi AWS Lambda, AppSpec file digunakan oleh CodeDeploy untuk menentukan:

• Versi fungsi Lambda mana yang akan diterapkan.

• Lambda mana yang berfungsi untuk digunakan sebagai tes validasi.

AppSpec File dapat diformat YAML atau diformat JSON. Anda juga dapat memasukkan konten AppSpec file langsung ke CodeDeploy konsol saat Anda membuat penerapan.

AppSpec file pada platform komputasi EC2/lokal

Jika aplikasi Anda menggunakan platform komputasi EC2/On-premise, AppSpec file tersebut harus berupa file berformat YAML yang diberi nama appspec.yml dan harus ditempatkan di root struktur direktori kode sumber aplikasi. Jika tidak, deployment gagal. Ini digunakan oleh CodeDeploy untuk menentukan:

• Apa yang harus diinstal ke instance Anda dari revisi aplikasi Anda di Amazon S3 atau. GitHub

• Acara siklus hidup mana yang akan dijalankan sebagai respons terhadap peristiwa siklus hidup penerapan.

Setelah Anda memiliki AppSpec file yang lengkap, Anda bundel, bersama dengan konten yang akan digunakan, ke dalam file arsip (zip, tar, atau tar terkompresi). Untuk informasi selengkapnya, lihat Bekerja dengan revisi aplikasi untuk CodeDeploy.

catatan

Format file arsip tar dan tar terkompresi (.tar dan.tar.gz) tidak didukung untuk instance Windows Server.

Setelah Anda memiliki file arsip yang dibundel (dikenal CodeDeploy sebagai revisi), Anda mengunggahnya ke bucket Amazon S3 atau repositori Git. Kemudian Anda gunakan CodeDeploy untuk menyebarkan revisi. Untuk petunjuk, lihat Buat penerapan dengan CodeDeploy.

Appspec.yl untuk penerapan platform komputasi EC2/On-premise disimpan di direktori root revisi Anda. Untuk informasi selengkapnya, lihat Menambahkan AppSpec file untuk penerapan EC2/On-premise dan Rencanakan revisi untuk CodeDeploy.

AppSpec Spasi file

Berikut ini adalah format yang benar untuk spasi AppSpec file. Angka-angka dalam tanda kurung siku menunjukkan jumlah spasi yang harus terjadi di antara item. Misalnya, [4] berarti menyisipkan empat spasi di antara item. CodeDeploy menimbulkan kesalahan yang mungkin sulit untuk di-debug jika lokasi dan jumlah spasi dalam AppSpec file tidak benar.

version:[1]version-number
os:[1]operating-system-name
files:
[2]-[1]source:[1]source-files-location
[4]destination:[1]destination-files-location
permissions:
[2]-[1]object:[1]object-specification
[4]pattern:[1]pattern-specification
[4]except:[1]exception-specification
[4]owner:[1]owner-account-name
[4]group:[1]group-name
[4]mode:[1]mode-specification
[4]acls: 
[6]-[1]acls-specification 
[4]context:
[6]user:[1]user-specification
[6]type:[1]type-specification
[6]range:[1]range-specification
[4]type:
[6]-[1]object-type
hooks:
[2]deployment-lifecycle-event-name:
[4]-[1]location:[1]script-location
[6]timeout:[1]timeout-in-seconds
[6]runas:[1]user-name

Berikut adalah contoh AppSpec file dengan spasi yang benar:

version: 0.0
os: linux
files:
  - source: /
    destination: /var/www/html/WordPress
hooks:
  BeforeInstall:
    - location: scripts/install_dependencies.sh
      timeout: 300
      runas: root
  AfterInstall:
    - location: scripts/change_permissions.sh
      timeout: 300
      runas: root
  ApplicationStart:
    - location: scripts/start_server.sh
    - location: scripts/create_test_db.sh
      timeout: 300
      runas: root
  ApplicationStop:
    - location: scripts/stop_server.sh
      timeout: 300
      runas: root

Untuk informasi selengkapnya tentang spasi, lihat spesifikasi YAMB.