Memasang Role dengan requirements.yml

Menjalankan perintah pemasangan satu per satu tidak akan efektif dalam skala besar. Berkas requirements.yml mencantumkan setiap dependensi sehingga seluruh proyek dapat dipasang sekaligus.

Anggap requirements.yml sebagai manifest paket Anda: berkas ini menyatakan dengan tepat peran dan koleksi mana yang diperlukan buku pedoman Anda agar dapat berjalan.

Di dalam berkas tersebut, kunci roles memuat sebuah daftar. Setiap entri menamai satu peran yang akan diambil dari Galaxy berdasarkan identitas author.name.

Kunci collections terpisah mencantumkan koleksi berdasarkan nama namespace.collection, sehingga satu berkas mencakup kedua jenis konten.

Selalu tambahkan versi agar pemasangan dapat direproduksi. Tanpa versi, Anda mungkin mengambil rilis yang lebih baru dan bermasalah di komputer rekan satu tim.

Arahkan ansible-galaxy ke berkas tersebut dengan -r, lalu perintah itu akan menyelesaikan dan memasang semua dependensi yang tercantum dalam satu langkah.

Perintah pemasangan biasa menangani peran. Untuk koleksi, gunakan subperintah collection install dengan tanda -r yang sama.

Entri peran dapat menggunakan URL Git src, bukan nama Galaxy, sehingga Anda dapat memasang peran pribadi atau yang belum dipublikasikan.

Tambahkan -p untuk menempatkan peran ke folder lokal proyek seperti roles/, bukan ke jalur global, sehingga setiap proyek tetap mandiri.

Secara default, peran yang sudah ada dipertahankan. Gunakan --force untuk mengunduh ulang dan menimpanya saat Anda menaikkan versi yang telah dikunci.

Commit requirements.yml ke Git, tetapi abaikan folder peran yang diunduh. Siapa pun dapat membangun ulang kumpulan yang sama persis dari manifes tersebut.

Cantumkan peran dan koleksi dalam requirements.yml, tetapkan versinya, lalu pasang semuanya dengan ansible-galaxy -r. Satu berkas, penyiapan yang dapat direproduksi. 📦