CodeDeploy AppSpec referensi berkas - AWS CodeDeploy
AppSpec file di platform ECS komputasi Amazon AppSpec file pada platform AWS Lambda komputasiAppSpec file pada platform EC2 komputasi /lokalAppSpec Spasi file

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

CodeDeploy AppSpec referensi berkas

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

File spesifikasi aplikasi (AppSpec file) adalah file YAML-format atau JSON -format yang digunakan oleh CodeDeploy untuk mengelola penyebaran.

catatan

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

Topik

AppSpec file di platform ECS komputasi Amazon

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

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

  • 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 ECS layanan Amazon Anda, seperti versi platform tempat ia berjalan, 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 atau YAML JSON -diformat. Anda juga dapat memasukkan konten AppSpec file langsung ke CodeDeploy konsol saat Anda membuat penerapan.

AppSpec file pada platform EC2 komputasi /lokal

Jika aplikasi Anda menggunakan platform EC2 komputasi /On-Premises, AppSpec file tersebut harus berupa file YAML -format bernama 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

  • Peristiwa 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, silakan lihat Buat penerapan dengan CodeDeploy.

Appspec.yl untuk penerapan platform komputasi EC2 /On-Premises disimpan di direktori root revisi Anda. Untuk informasi selengkapnya, silakan 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 YAMLspesifikasinya.