Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Bagaimana sinkronisasi Git bekerja dengan CloudFormation
Topik ini menjelaskan cara kerja sinkronisasi Git dan memperkenalkan konsep-konsep kunci yang diperlukan untuk bekerja dengannya.
**Topics**
+ [Cara kerja sinkronisasi Git](#git-sync-concepts-terms-how)
+ [Komentar pada permintaan tarik](#git-sync-comments-on-pull-requests)
+ [File penyebaran tumpukan](#git-sync-concepts-terms-depoyment-file)
+ [CloudFormation berkas templat](#git-sync-concepts-terms-template-file)
+ [Repositori definisi templat](#git-sync-concepts-terms-template-definition-repository)
## Cara kerja sinkronisasi Git
Untuk menggunakan sinkronisasi Git, pertama-tama Anda harus menghubungkan penyedia Git untuk CloudFormation menggunakan [CodeConnections](https://docs.aws.amazon.com/codeconnections/latest/APIReference/Welcome.html)layanan. Dalam prosedur dalam panduan ini, koneksi dibuat melalui CodeConnections konsol. Atau, Anda dapat membuat koneksi dengan AWS CLI. Anda dapat menggunakan salah satu penyedia Git berikut:
+ [GitHub](https://github.com/)
+ [GitHub Perusahaan](https://github.com/enterprise/)
+ [GitLab](https://about.gitlab.com/)
+ [Bitbucket](https://bitbucket.org)
+ [GitLabdikelola sendiri](https://docs.gitlab.com/subscriptions/self_managed/)
Selanjutnya, Anda membuat CloudFormation template yang mendefinisikan tumpukan Anda dan menambahkannya ke repositori Anda. File template ini dipantau. CloudFormation memperbarui tumpukan secara otomatis saat perubahan dilakukan padanya.
Di CloudFormation konsol, Anda membuat tumpukan baru dan memilih **Sinkronkan dari Git** untuk memberitahu CloudFormation agar menggunakan sinkronisasi Git. Anda akan menentukan repositori dan cabang yang CloudFormation ingin Anda pantau, dan menentukan CloudFormation template di repositori Anda yang mendefinisikan tumpukan.
Selama konfigurasi, Anda dapat menyediakan file penyebaran tumpukan Anda sendiri dari repositori Anda, atau membuat sinkronisasi Git untuk Anda. File penyebaran tumpukan berisi parameter dan nilai yang mengonfigurasi sumber daya di tumpukan Anda. File penyebaran tumpukan ini dipantau. CloudFormation memperbarui tumpukan secara otomatis saat perubahan dilakukan padanya.
Sinkronisasi Git membuat permintaan tarik di repositori Anda untuk menyinkronkan tumpukan Anda dengan file CloudFormation template dan file penyebaran tumpukan. Jika Git sync menghasilkan file penyebaran tumpukan untuk Anda, itu dikirimkan ke repositori Anda oleh sinkronisasi Git.
Anda kemudian menggabungkan permintaan tarik ke repositori Anda sehingga CloudFormation menyediakan tumpukan, mengonfigurasinya dengan parameter penerapan Anda, dan mulai memantau repositori Anda untuk perubahan.
Sejak saat itu, setiap kali Anda membuat perubahan pada file template atau file penyebaran tumpukan dan memasukkannya ke repositori Anda, CloudFormation akan secara otomatis mendeteksi perubahan. Jika tim Anda menggunakan permintaan tarik, anggota tim Anda kemudian dapat meninjau dan menyetujui perubahan sebelum diterapkan. Setelah permintaan tarik diterima, CloudFormation gunakan perubahan Anda.
Anda dapat memantau status konfigurasi sinkronisasi Git Anda untuk tumpukan dan melihat riwayat komit yang diterapkan ke tumpukan di CloudFormation konsol. Konsol ini juga menyediakan alat untuk mengonfigurasi ulang masalah sinkronisasi Git dan pemecahan masalah.
## Komentar pada permintaan tarik
Anda dapat memilih untuk CloudFormation membuat ringkasan perubahan kode dalam permintaan tarik melalui CodeConnections layanan dengan mengaktifkan opsi **Aktifkan komentar pada permintaan tarik** di konsol. Memberikan ringkasan perubahan permintaan tarik berarti anggota tim dapat dengan mudah meninjau dan memahami dampak modifikasi yang diusulkan sebelum menggabungkan permintaan tarik. Untuk informasi selengkapnya, lihat [Aktifkan CloudFormation untuk memposting ringkasan perubahan tumpukan dalam permintaan tarik](gitsync-enable-comments-on-pull-requests.md).
## File penyebaran tumpukan
File penyebaran tumpukan adalah file berformat standar JavaScript Object Notation (JSON) atau YAMAL yang berisi parameter dan nilai yang mengelola tumpukan Anda. CloudFormation Itu dipantau untuk perubahan. Ketika perubahan pada file berkomitmen ke repositori, tumpukan terkait diperbarui secara otomatis.
File penyebaran tumpukan berisi pasangan kunci-nilai dan dua kamus:
+ `template-file-path`
Ini adalah jalur repositori lengkap untuk file CloudFormation template. File template mendeklarasikan sumber daya untuk CloudFormation tumpukan yang terkait dengan file penerapan ini.
+ `parameters`
Kamus parameter berisi pasangan kunci-nilai yang mengonfigurasi sumber daya dalam tumpukan. File penyebaran tumpukan dapat memiliki hingga 50 parameter.
+ `tags`
Kamus tag berisi pasangan nilai kunci opsional yang dapat Anda gunakan untuk mengidentifikasi dan mengkategorikan sumber daya dalam tumpukan. File penyebaran tumpukan dapat memiliki hingga 50 tag.
Anda dapat menyediakan file penyebaran tumpukan Anda sendiri, atau membuat sinkronisasi Git untuk Anda dan secara otomatis mengirimkan permintaan tarik ke repositori Anda. Anda dapat mengelola parameter dan tag dengan mengedit file penyebaran tumpukan dan melakukan perubahan pada repositori.
Berikut ini adalah contoh file penyebaran tumpukan sinkronisasi Git:
```
template-file-path: fargate-srvc/my-stack-template.yaml
parameters:
image: public.ecr.aws/lts/nginx:latest
task_size: x-small
max_capacity: 5
port: 8080
env: production
tags:
cost-center: '123456'
org: 'AWS'
```
## CloudFormation berkas templat
File template berisi deklarasi AWS sumber daya yang membentuk CloudFormation tumpukan. Dengan sinkronisasi Git, file template disimpan di repositori Git Anda dan direferensikan oleh file penyebaran tumpukan. Anda dapat mengelola tumpukan dengan mengedit file template dan melakukan perubahan pada repositori.
Untuk informasi selengkapnya, lihat [Bekerja dengan CloudFormation template](template-guide.md).
## Repositori definisi templat
Repositori definisi template adalah repositori Git yang ditautkan melalui CloudFormation sinkronisasi Git. Repositori dipantau untuk perubahan pada CloudFormation template dan file penyebaran tumpukan. Saat Anda melakukan perubahan pada file, tumpukan terkait diperbarui secara otomatis.
**penting**
Saat Anda mengonfigurasi repositori definisi template di konsol sinkronisasi Git, pilih *repositori dan cabang yang benar *dari* koneksi Git*. Git sync hanya memantau repositori dan cabang yang dikonfigurasi untuk perubahan pada CloudFormation template dan file penyebaran tumpukan.