Repositori Buku Masak

penting

AWS OpsWorks Stacks Layanan ini mencapai akhir masa pakai pada 26 Mei 2024 dan telah dinonaktifkan untuk pelanggan baru dan yang sudah ada. Kami sangat menyarankan pelanggan untuk memindahkan beban kerja mereka ke solusi lain sesegera mungkin. Jika Anda memiliki pertanyaan tentang migrasi, hubungi AWS Support Tim di AWS re:Post atau melalui AWS Dukungan Premium.

Buku masak kustom Anda harus disimpan dalam repositori online, baik arsip seperti file.zip atau manajer kontrol sumber seperti Git. Tumpukan hanya dapat memiliki satu repositori buku masak khusus, tetapi repositori dapat berisi sejumlah buku masak. Saat Anda menginstal atau memperbarui buku masak, AWS OpsWorks Stacks menginstal seluruh repositori dalam cache lokal pada setiap instance tumpukan. Ketika sebuah instance membutuhkan, misalnya, untuk menjalankan satu atau lebih resep, ia menggunakan kode dari cache lokal.

Berikut ini menjelaskan cara menyusun repositori buku masak Anda, yang tergantung pada jenisnya. Teks yang dicetak miring dalam ilustrasi mewakili direktori dan nama file yang ditentukan pengguna, termasuk nama repositori atau arsip.

Manajer Kontrol Sumber

AWS OpsWorks Stacks mendukung manajer kontrol sumber berikut:

• Tumpukan Linux — Git dan Subversion

• Tumpukan Windows - Git

Berikut ini menunjukkan direktori dan struktur file yang diperlukan:

• Direktori buku masak semuanya harus berada di tingkat atas.

Arsip

AWS OpsWorks Stacks mendukung arsip berikut:

• Tumpukan Linux — file zip, gzip, bzip2, atau tarball, disimpan di Amazon S3 atau situs web (arsip HTTP).

  AWS OpsWorks Tumpukan tidak mendukung tarball yang tidak terkompresi.

• Tumpukan Windows — file zip dan tgz (tar terkompresi gzip), disimpan di Amazon S3.

Berikut ini menunjukkan direktori dan struktur file yang diperlukan, yang tergantung pada apakah Anda menjalankan tumpukan Linux atau Windows. Struktur buku masak sama dengan repositori SCM, sehingga diwakili oleh elipsis (...).

• Tumpukan Linux — Direktori buku masak harus terkandung dalam direktori root.

• Tumpukan Windows — Buku masak harus berada di tingkat atas arsip.

  Jika Anda hanya memiliki satu buku masak, Anda dapat secara opsional menghilangkan direktori buku masak dan meletakkan file buku masak di tingkat atas. Dalam hal ini, AWS OpsWorks Stacks memperoleh nama buku masak dari metadata.rb.

Setiap direktori buku masak memiliki setidaknya satu dan biasanya semua direktori dan file standar berikut, yang harus menggunakan nama standar:

• attributes— File atribut buku masak.

• recipes— File resep buku masak.

• templates— File templat buku masak.

• Lainnya — Direktori yang ditentukan pengguna opsional yang berisi jenis file lain, seperti definisi atau spesifikasi.

• metadata.rb— Metadata buku masak.

  Untuk Chef 11.10 dan yang lebih baru, jika resep Anda bergantung pada buku masak lain, Anda harus menyertakan depends pernyataan yang sesuai dalam file buku masak Anda. metadata.rb Misalnya, jika buku masak Anda menyertakan resep dengan pernyataan sepertiinclude_recipe anothercookbook::somerecipe, metadata.rb file buku masak Anda harus menyertakan baris berikut:. depends "anothercookbook" Untuk informasi lebih lanjut, lihat Tentang Metadata Buku Masak.

Template harus dalam subdirektori templates direktori, yang berisi setidaknya satu dan opsional beberapa subdirektori. Subdirektori tersebut secara opsional dapat memiliki subdirektori juga.

• Template biasanya memiliki default subdirektori, yang berisi file template yang digunakan Chef secara default.

• lain mewakili subdirektori opsional yang dapat digunakan untuk template khusus sistem operasi.

• Chef secara otomatis menggunakan template dari subdirektori yang sesuai, berdasarkan konvensi penamaan yang dijelaskan dalam Kekhususan File. Misalnya, untuk sistem operasi Amazon Linux dan Ubuntu, Anda dapat menempatkan template khusus sistem operasi di subdirektori bernama amazon atau, masing-masing. ubuntu

Detail bagaimana Anda menangani buku masak khusus bergantung pada jenis repositori pilihan Anda.

Untuk menggunakan arsip

1. Terapkan buku masak Anda dengan menggunakan struktur folder yang ditunjukkan di bagian sebelumnya.

2. Buat arsip terkompresi dan unggah ke bucket Amazon S3 atau situs web.

   Jika Anda memperbarui buku masak Anda, Anda harus membuat dan mengunggah file arsip baru. Konten yang dikirimkan ke bucket Amazon S3 mungkin berisi konten pelanggan. Untuk informasi selengkapnya tentang menghapus data sensitif, lihat Bagaimana Cara Mengosongkan Bucket S3? atau Bagaimana Saya Menghapus Bucket S3? .

Untuk menggunakan SCM

1. Siapkan repositori Git atau Subversion menggunakan struktur yang ditunjukkan sebelumnya.

2. Secara opsional, gunakan fitur kontrol versi repositori untuk mengimplementasikan beberapa cabang atau versi.

   Jika Anda memperbarui buku masak Anda, Anda dapat melakukannya di cabang baru dan langsung OpsWorks menggunakan versi baru. Anda juga dapat menentukan versi tag tertentu. Lihat perinciannya di Menentukan Repositori Cookbook Kustom.

Memasang Buku Masak Kustommenjelaskan cara agar AWS OpsWorks Stacks menginstal repositori buku masak Anda pada instance tumpukan.

penting

Setelah Anda memperbarui buku masak yang ada di repositori, Anda harus menjalankan perintah update_cookbooks stack untuk mengarahkan AWS OpsWorks Stacks untuk memperbarui cache lokal setiap instans online. Untuk informasi selengkapnya, lihat Jalankan Perintah Stack.