Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# CodeCommit referensi tindakan sumber
Memulai pipeline saat komit baru dibuat pada CodeCommit repositori dan cabang yang dikonfigurasi.
Jika Anda menggunakan konsol untuk membuat atau mengedit pipeline, CodePipeline buat EventBridge aturan yang memulai pipeline saat terjadi perubahan di repositori.
**catatan**
Untuk Amazon ECR, Amazon S3, CodeCommit atau sumber, Anda juga dapat membuat penggantian sumber menggunakan entri transformasi input untuk menggunakan `revisionValue` peristiwa EventBridge in untuk pipeline Anda, yang berasal dari variabel peristiwa sumber untuk kunci objek, komit, atau ID gambar Anda. `revisionValue` Untuk informasi selengkapnya, lihat langkah opsional untuk entri transformasi masukan yang disertakan dalam prosedur di bawah[Tindakan sumber dan sumber daya Amazon ECR EventBridge](create-cwe-ecr-source.md),[Menyambungkan ke tindakan sumber Amazon S3 dengan sumber yang diaktifkan untuk acara](create-S3-source-events.md), atau[CodeCommit tindakan sumber dan EventBridge](triggering.md).
Anda harus sudah membuat CodeCommit repositori sebelum menghubungkan pipeline melalui tindakan. CodeCommit
Setelah perubahan kode terdeteksi, Anda memiliki opsi berikut untuk meneruskan kode ke tindakan selanjutnya:
+ **Default** - Mengkonfigurasi tindakan CodeCommit sumber untuk menampilkan file ZIP dengan salinan dangkal dari komit Anda.
+ **Full clone** — Mengonfigurasi aksi sumber untuk menampilkan referensi URL Git ke repositori untuk tindakan selanjutnya.
Saat ini, referensi URL Git hanya dapat digunakan oleh CodeBuild tindakan hilir untuk mengkloning repo dan metadata Git terkait. Mencoba meneruskan referensi URL Git ke CodeBuild non-tindakan menghasilkan kesalahan.
**Topics**
+ [
## Tipe tindakan
](#action-reference-CodeCommit-type)
+ [
## Parameter konfigurasi
](#action-reference-CodeCommit-config)
+ [
## Artefak masukan
](#action-reference-CodeCommit-input)
+ [
## Artefak keluaran
](#action-reference-CodeCommit-output)
+ [
## Variabel keluaran
](#action-reference-CodeCommit-variables)
+ [
## Izin peran layanan: tindakan CodeCommit
](#edit-role-codecommit)
+ [
## Contoh konfigurasi tindakan
](#action-reference-CodeCommit-example)
+ [
## Lihat juga
](#action-reference-CodeCommit-links)
## Tipe tindakan
+ Kategori: `Source`
+ Pemilik: `AWS`
+ Penyedia: `CodeCommit`
+ Versi: `1`
## Parameter konfigurasi
**RepositoryName**
Wajib: Ya
Nama repositori tempat perubahan sumber akan dideteksi.
**BranchName**
Wajib: Ya
Nama cabang tempat perubahan sumber harus dideteksi.
**PollForSourceChanges**
Wajib: Tidak
`PollForSourceChanges`mengontrol apakah CodePipeline polling CodeCommit repositori untuk perubahan sumber. Kami menyarankan Anda menggunakan CloudWatch Acara untuk mendeteksi perubahan sumber sebagai gantinya. Untuk informasi selengkapnya tentang mengonfigurasi CloudWatch Acara, lihat [Migrasi jalur pemungutan suara (CodeCommit sumber) (CLI)](update-change-detection.md#update-change-detection-cli-codecommit) atau[Migrasikan jalur pemungutan suara (CodeCommit sumber) (templat)CloudFormation](update-change-detection.md#update-change-detection-cfn-codecommit).
Jika ingin mengonfigurasi aturan CloudWatch Peristiwa, Anda harus mengatur `PollForSourceChanges` `false` untuk menghindari eksekusi pipeline duplikat.
Nilai yang valid untuk parameter ini:
+ `true`: Jika disetel, CodePipeline polling repositori Anda untuk perubahan sumber.
**catatan**
Jika Anda menghilangkan`PollForSourceChanges`, CodePipeline default untuk polling repositori Anda untuk perubahan sumber. Perilaku ini sama seperti jika `PollForSourceChanges` disertakan dan disetel ke`true`.
+ `false`: Jika disetel, CodePipeline tidak melakukan polling repositori Anda untuk perubahan sumber. Gunakan setelan ini jika Anda ingin mengonfigurasi aturan CloudWatch Peristiwa untuk mendeteksi perubahan sumber.
****OutputArtifactFormat****
Wajib: Tidak
Format artefak keluaran. Nilai dapat berupa `CODEBUILD_CLONE_REF` atau`CODE_ZIP`. Jika tidak ditentukan, defaultnya adalah`CODE_ZIP`.
`CODEBUILD_CLONE_REF`Opsi ini hanya dapat digunakan oleh tindakan CodeBuild hilir.
Jika Anda memilih opsi ini, Anda perlu menambahkan `codecommit:GitPull` izin ke peran CodeBuild layanan Anda seperti yang ditunjukkan pada[Tambahkan CodeBuild GitClone izin untuk tindakan CodeCommit sumber](troubleshooting.md#codebuild-role-codecommitclone). Anda juga perlu menambahkan `codecommit:GetRepository` izin ke peran CodePipeline layanan Anda seperti yang ditunjukkan pada[Menambahkan izin ke peran CodePipeline layanan](how-to-custom-role.md#how-to-update-role-new-services). Untuk tutorial yang menunjukkan cara menggunakan opsi **klon Penuh**, lihat[Tutorial: Gunakan klon lengkap dengan sumber CodeCommit pipa](tutorials-codecommit-gitclone.md).
## Artefak masukan
+ **Jumlah artefak:** `0`
+ **Deskripsi:** Artefak masukan tidak berlaku untuk jenis tindakan ini.
## Artefak keluaran
+ **Jumlah artefak:** `1`
+ **Deskripsi:** Artefak keluaran dari tindakan ini adalah file ZIP yang berisi konten repositori dan cabang yang dikonfigurasi pada komit yang ditentukan sebagai revisi sumber untuk eksekusi pipeline. Artefak yang dihasilkan dari repositori adalah artefak keluaran untuk tindakan tersebut. CodeCommit ID komit kode sumber ditampilkan CodePipeline sebagai revisi sumber untuk eksekusi pipeline yang dipicu.
## Variabel keluaran
Ketika dikonfigurasi, tindakan ini menghasilkan variabel yang dapat direferensikan oleh konfigurasi tindakan tindakan hilir dalam pipeline. Tindakan ini menghasilkan variabel yang dapat dilihat sebagai variabel keluaran, bahkan jika tindakan tidak memiliki namespace. Anda mengonfigurasi tindakan dengan namespace untuk membuat variabel-variabel tersebut tersedia untuk konfigurasi tindakan hilir.
Untuk informasi selengkapnya, lihat [Referensi variabel](reference-variables.md).
**CommitId**
ID CodeCommit komit yang memicu eksekusi pipeline. Komit IDs adalah SHA penuh dari komit.
**CommitMessage**
Pesan deskripsi, jika ada, terkait dengan komit yang memicu eksekusi pipeline.
**RepositoryName**
Nama CodeCommit repositori tempat komit yang memicu pipeline dibuat.
**BranchName**
Nama cabang untuk CodeCommit repositori tempat perubahan sumber dilakukan.
**AuthorDate**
Tanggal ketika komit ditulis, dalam format stempel waktu.
**CommitterDate**
Tanggal ketika komit dilakukan, dalam format stempel waktu.
## Izin peran layanan: tindakan CodeCommit
Saat CodePipeline menjalankan tindakan, kebijakan peran CodePipeline layanan memerlukan izin berikut, yang dicakup dengan tepat ke ARN sumber daya pipeline untuk mempertahankan akses dengan hak istimewa paling sedikit. Misalnya, tambahkan yang berikut ini ke pernyataan kebijakan Anda:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"codecommit:CancelUploadArchive",
"codecommit:GetBranch",
"codecommit:GetCommit",
"codecommit:GetRepository",
"codecommit:GetUploadArchiveStatus",
"codecommit:UploadArchive"
],
"Resource": [
"arn:aws:codecommit:*:111122223333:[[codecommitRepostories]]"
]
}
]
}
```
------
## Contoh konfigurasi tindakan
### Contoh untuk format artefak keluaran default
------
#### [ YAML ]
```
name: Source
actionTypeId:
category: Source
owner: AWS
provider: CodeCommit
version: '1'
runOrder: 1
configuration:
BranchName: main
PollForSourceChanges: 'false'
RepositoryName: MyWebsite
outputArtifacts:
- name: Artifact_MyWebsiteStack
inputArtifacts: []
region: us-west-2
namespace: SourceVariables
```
------
#### [ JSON ]
```
{
"name": "Source",
"actionTypeId": {
"category": "Source",
"owner": "AWS",
"provider": "CodeCommit",
"version": "1"
},
"runOrder": 1,
"configuration": {
"BranchName": "main",
"PollForSourceChanges": "false",
"RepositoryName": "MyWebsite"
},
"outputArtifacts": [
{
"name": "Artifact_MyWebsiteStack"
}
],
"inputArtifacts": [],
"region": "us-west-2",
"namespace": "SourceVariables"
}
```
------
### Contoh untuk format artefak keluaran klon penuh
------
#### [ YAML ]
```
name: Source
actionTypeId:
category: Source
owner: AWS
provider: CodeCommit
version: '1'
runOrder: 1
configuration:
BranchName: main
OutputArtifactFormat: CODEBUILD_CLONE_REF
PollForSourceChanges: 'false'
RepositoryName: MyWebsite
outputArtifacts:
- name: SourceArtifact
inputArtifacts: []
region: us-west-2
namespace: SourceVariables
```
------
#### [ JSON ]
```
{
"name": "Source",
"actionTypeId": {
"category": "Source",
"owner": "AWS",
"provider": "CodeCommit",
"version": "1"
},
"runOrder": 1,
"configuration": {
"BranchName": "main",
"OutputArtifactFormat": "CODEBUILD_CLONE_REF",
"PollForSourceChanges": "false",
"RepositoryName": "MyWebsite"
},
"outputArtifacts": [
{
"name": "SourceArtifact"
}
],
"inputArtifacts": [],
"region": "us-west-2",
"namespace": "SourceVariables"
}
```
------
## Lihat juga
Sumber daya terkait berikut dapat membantu Anda saat Anda bekerja dengan tindakan ini.
+ [Tutorial: Buat pipeline sederhana (CodeCommit repositori)](tutorials-simple-codecommit.md)— Tutorial ini menyediakan contoh file spesifikasi aplikasi dan contoh CodeDeploy aplikasi dan kelompok penyebaran. Gunakan tutorial ini untuk membuat pipeline dengan CodeCommit sumber yang menyebarkan ke instans Amazon EC2.