View a markdown version of this page

Membuat konfigurasi sinkronisasi template - AWS Proton
Menyinkronkan templat layanan

Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, dukungan AWS akan berakhir untuk AWS Proton. Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses AWS Proton konsol atau AWS Proton sumber daya. Infrastruktur yang Anda gunakan akan tetap utuh. Untuk informasi selengkapnya, lihat Panduan AWS Proton Penghentian Layanan dan Migrasi.

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

Membuat konfigurasi sinkronisasi template

Pelajari cara membuat konfigurasi sinkronisasi template dengan AWS Proton.

Buat prasyarat konfigurasi sinkronisasi template:
Tautan repositori terdiri dari yang berikut:

  • Kon CodeConnections eksi yang memberikan AWS Proton izin untuk mengakses repositori Anda dan berlangganan notifikasi.

  • Per an terkait layanan. Saat Anda menautkan repositori Anda, peran terkait layanan dibuat untuk Anda.

Sebelum Anda membuat konfigurasi sinkronisasi template pertama, dorong bundel template ke repositori Anda seperti yang ditunjukkan pada tata letak direktori berikut.

 /templates/                                                 # subdirectory (optional)
 /templates/my-env-template/                                 # template name
 /templates/my-env-template/v1/                              # template version
 /templates/my-env-template/v1/infrastructure/               # template bundle
 /templates/my-env-template/v1/schema/

Setelah Anda membuat konfigurasi sinkronisasi template pertama, versi template baru secara otomatis dibuat saat Anda mendorong komit yang menambahkan bundel template yang diperbarui di bawah versi baru (misalnya, di bawah/my-env-template/v2/).

 /templates/                                                 # subdirectory (optional)
 /templates/my-env-template/                                 # template name
 /templates/my-env-template/v1/                              # template version
 /templates/my-env-template/v1/infrastructure/               # template bundle
 /templates/my-env-template/v1/schema/
 /templates/my-env-template/v2/
 /templates/my-env-template/v2/infrastructure/
 /templates/my-env-template/v2/schema/

Anda dapat menyertakan versi bundel template baru untuk satu atau beberapa templat yang dikonfigurasi sinkronisasi dalam satu komit. AWS Proton membuat versi template baru untuk setiap versi bundel template baru yang disertakan dalam komit.

Setelah Anda membuat konfigurasi sinkronisasi template, Anda masih dapat membuat versi baru template secara manual di konsol atau AWS CLI dengan mengunggah bundel template dari bucket S3. Sinkronisasi templat hanya berfungsi dalam satu arah: dari repositori Anda ke AWS Proton. Versi template yang dibuat secara manual tidak dis inkronkan.

Setelah Anda mengatur konfigurasi sinkronisasi template, AWS Proton mendengarkan perubahan pada repositori Anda. Setiap kali perubahan didorong, ia mencari direktori apa pun yang memiliki nama yang sama dengan template Anda. Kemudian melihat di dalam direktori itu untuk direktori apa pun yang terlihat seperti versi utama. AWS Proton mendaftarkan bundel template ke versi utama template yang sesuai. Versi baru selalu ada di DRAFT negara bagian. Anda dapat menerbitkan versi baru dengan konsol atau AWS CLI.

Misalnya, Anda memiliki template yang disebut my-env-template dikonfigurasi untuk menyinkronkan dari my-repo/templates cabang main dengan tata letak berikut.

 /code
 /code/service.go
 README.md
 /templates/
 /templates/my-env-template/
 /templates/my-env-template/v1/
 /templates/my-env-template/v1/infrastructure/
 /templates/my-env-template/v1/schema/
 /templates/my-env-template/v2/
 /templates/my-env-template/v2/infrastructure/
 /templates/my-env-template/v2/schema/

AWS Proton menyinkronkan isi /templates/my-env-template/v1/ ke my-env-template:1 dan isi /templates/my-env-template/v2/ kemy-env-template:2. Jika mereka belum ada, itu menciptakan versi utama ini.

AWS Proton menemukan direktori pertama yang cocok dengan nama template. Anda dapat membatasi AWS Proton pencarian direktori dengan menentukan subdirectoryPath kapan Anda membuat atau mengedit konfigurasi sinkronisasi template. Misalnya, Anda dapat menentukan /production-templates/ untuksubdirectoryPath.

Anda dapat membuat konfigurasi sinkronisasi template menggunakan konsol atau CLI.

Konsol Manajemen AWS
Buat template dan konfigurasi sinkronisasi template menggunakan konsol.

  1. Di AWS Proton konsol, pilih Tem plate lingkungan.

  2. Pilih Buat template lingkungan.

  3. Di halaman Buat template lingkungan, di bagian Pilihan Template, pilih Buat template untuk penyediaan lingkungan baru.

  4. Di bagian sumber bundel template, pilih Sin kronkan template dari Git.

  5. Di bagian repositori kode sumber:

    1. Untuk Repositori, pilih repositori tertaut yang berisi bundel template Anda.

    2. Untuk Cabang, pilih cabang repositori untuk disinkronkan.

    3. (Opsional) Untuk direktori bundel Template, masukkan nama direktori untuk menelusuri pencarian bundel template Anda.

  6. Di bagian detail Template.

    1. Masukkan nama Template.

    2. (Opsional) Masukkan nama tampilan Template.

    3. (Opsional) Masukkan deskripsi Template untuk template lingkungan.

  7. (Opsional) Centang kotak untuk Ku stomisasi pengaturan enkripsi (lanjutan) di bagian Peng aturan enkripsi untuk menyediakan kunci enkripsi Anda sendiri.

  8. (Opsional) Di bagian Tag, pilih Tambahkan tag baru dan masukkan kunci dan nilai untuk membuat tag yang dikelola pelanggan.

  9. Pilih Buat Template Lingkungan.

    Anda sekarang berada di halaman baru yang menampilkan status dan detail untuk template lingkungan baru Anda. Rincian ini mencakup daftar tag yang AWS dikelola dan yang dikelola pelanggan. AWS Proton secara otomatis menghasilkan AWS tag terkelola untuk Anda saat Anda membuat AWS Proton sumber daya. Untuk informasi selengkapnya, lihat AWS Proton sumber daya dan penandaan.

  10. Di halaman detail template, pilih tab Sin kronisasi untuk melihat data detail konfigurasi sinkronisasi template.

  11. Pilih tab Versi template untuk melihat versi template dengan detail status.

  12. Status status template lingkungan baru dimulai dalam status D raf. Anda dan orang lain dengan proton:CreateEnvironment izin dapat melihat dan mengaksesnya. Ikuti langkah selanjutnya untuk membuat template tersedia untuk orang lain.

  13. Di bagian Versi template, pilih tombol radio di sebelah kiri versi minor template yang baru saja Anda buat (1.0). Sebagai alternatif, Anda dapat memilih Publikasikan di peringatan info dan lewati langkah berikutnya.

  14. Di bagian Versi Template, pilih Publi kasikan.

  15. Status template berubah menjadi Diter bitkan. Ini adalah versi terbaru dan Direkomendasikan dari template.

  16. Di panel navigasi, pilih Template lingkungan untuk melihat daftar templat dan detail lingkungan Anda.

Prosedur untuk membuat template layanan dan konfigurasi sinkronisasi templat serupa.

AWS CLI
Buat template dan konfigurasi sinkronisasi template menggunakan AWS CLI.
  1. Buat templat. Dalam contoh ini, template lingkungan dibuat.

    Jalankan perintah berikut.

    $ aws proton create-environment-template \
    --name "env-template"

    Tanggapannya adalah sebagai berikut.

    {
    "environmentTemplate": {
        "arn": "arn:aws:proton:us-east-1:123456789012:environment-template/env-template",
        "createdAt": "2021-11-07T23:32:43.045000+00:00",
        "displayName": "env-template",
        "lastModifiedAt": "2021-11-07T23:32:43.045000+00:00",
        "name": "env-template",
        "status": "DRAFT",
        "templateName": "env-template"
    }
}
  2. Buat konfigurasi sinkronisasi template Anda dengan AWS CLI dengan menyediakan yang berikut:

    • Template yang ingin Anda sinkronkan. Setelah Anda membuat konfigurasi sinkronisasi template, Anda masih dapat membuat versi baru darinya secara manual di konsol atau dengan AWS CLI.

    • Nama template.

    • Jenis template.

    • Repositori tertaut yang ingin Anda sinkronkan.

    • Penyedia repositori tertaut.

    • Cabang tempat bundel template berada.

    • (Opsional) Jalur ke direktori yang berisi bundel template Anda. Secara default, AWS Proton cari direktori pertama yang cocok dengan nama template Anda.

    Jalankan perintah berikut.

    $ aws proton create-template-sync-config \
    --template-name "env-template" \
    --template-type "ENVIRONMENT" \
    --repository-name "myrepos/templates" \
    --repository-provider "GITHUB" \
    --branch "main" \
    --subdirectory "env-template/"

    Tanggapannya adalah sebagai berikut.

    {
    "templateSyncConfigDetails": {
        "branch": "main",
        "repositoryName": "myrepos/templates",
        "repositoryProvider": "GITHUB",
        "subdirectory": "templates",
        "templateName": "env-template",
        "templateType": "ENVIRONMENT"
    }
}

  3. Untuk menerbitkan versi template Anda, lihatDaftarkan dan publikasikan templat.

Menyinkronkan templat layanan

Contoh sebelumnya menunjukkan bagaimana Anda dapat menyinkronkan template lingkungan. Template layanan serupa. Untuk menyinkronkan templat layanan, Anda menambahkan file tambahan yang .template-registration.yaml diberi nama ke setiap direktori versi utama dalam bundel template Anda. File ini berisi detail tambahan AWS Proton yang diperlukan saat membuat versi template layanan untuk Anda mengikuti komit. Saat Anda secara eksplisit membuat versi template layanan menggunakan AWS Proton konsol atau API, Anda memberikan rincian ini sebagai input, dan file ini menggantikan input ini untuk sinkronisasi template.

./templates/                                                 # subdirectory (optional)
 /templates/my-svc-template/                                 # service template name
 /templates/my-svc-template/v1/                              # service template version
 /templates/my-svc-template/v1/.template-registration.yaml   # service template version properties
 /templates/my-svc-template/v1/instance_infrastructure/      # template bundle
 /templates/my-svc-template/v1/schema/

.template-registration.yamlFile berisi rincian berikut:

  • Lingkungan yang kompatibel [wajib] - Lingkungan berdasarkan templat lingkungan ini dan versi utama kompatibel dengan layanan berdasarkan versi template layanan ini.

  • Sumber komponen yang didukung [opsional] - Komponen yang menggunakan sumber ini kompatibel dengan layanan berdasarkan versi template layanan ini. Jika tidak ditentukan, komponen tidak dapat dilampirkan ke layanan ini. Untuk informasi selengkapnya tentang komponen, lihatAWS Proton komponen.

Sintaks YAML file adalah sebagai berikut:

compatible_environments:
  - env-templ-name:major-version
  - ...
supported_component_sources:
  - DIRECTLY_DEFINED

Tentukan satu atau lebih template lingkungan/kombinasi versi utama. Men supported_component_sources entukan adalah opsional, dan satu-satunya nilai yang didukung adalahDIRECTLY_DEFINED.

contoh.template-registrasi.yaml

Dalam contoh ini, versi template layanan kompatibel dengan versi utama 1 dan 2 dari template my-env-template lingkungan. Ini juga kompatibel dengan versi utama 1 dan 3 dari template another-env-template lingkungan. File tidak menentukansupported_component_sources, sehingga komponen tidak dapat dilampirkan ke layanan berdasarkan versi template layanan ini.

compatible_environments:
  - my-env-template:1
  - my-env-template:2
  - another-env-template:1
  - another-env-template:3
catatan

Sebelumnya, AWS Proton mendefinisikan file yang berbeda,.compatible-envs, untuk menentukan lingkungan yang kompatibel. AWS Proton masih mendukung file itu dan formatnya untuk kompatibilitas mundur. Kami tidak merekomendasikan menggunakannya lagi, karena tidak dapat diperluas dan tidak dapat mendukung fitur yang lebih baru seperti komponen.