Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# CodeStarSourceConnection untuk Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com, dan tindakan yang dikelola GitLab sendiri
Tindakan sumber untuk koneksi didukung oleh AWS CodeConnections. CodeConnections memungkinkan Anda untuk membuat dan mengelola koneksi antara AWS sumber daya dan repositori pihak ketiga seperti. GitHub Memulai pipeline saat komit baru dibuat pada repositori kode sumber pihak ketiga. Tindakan sumber mengambil perubahan kode saat pipeline dijalankan secara manual atau saat peristiwa webhook dikirim dari penyedia sumber.
Anda dapat mengonfigurasi tindakan dalam pipeline Anda untuk menggunakan konfigurasi Git yang memungkinkan Anda memulai pipeline dengan pemicu. Untuk mengonfigurasi konfigurasi pemicu pipeline untuk memfilter dengan pemicu, lihat detail selengkapnya di[Tambahkan pemicu dengan tipe acara permintaan push atau pull kode](pipelines-filter.md).
**catatan**
Fitur ini tidak tersedia di Asia Pasifik (Hong Kong), Asia Pasifik (Hyderabad), Asia Pasifik (Jakarta), Asia Pasifik (Melbourne), Asia Pasifik (Osaka), Afrika (Cape Town), Timur Tengah (Bahrain), Timur Tengah (UEA), Eropa (Spanyol), Eropa (Zurich), Israel (Tel Aviv), atau (AS-Barat) Wilayah. AWS GovCloud Untuk mereferensikan tindakan lain yang tersedia, lihat[Integrasi produk dan layanan dengan CodePipeline](integrations.md). Untuk pertimbangan dengan tindakan ini di Wilayah Eropa (Milan), lihat catatan di[CodeStarSourceConnection untuk Bitbucket Cloud, GitHub Enterprise Server GitHub, GitLab .com, dan tindakan yang dikelola GitLab sendiri](#action-reference-CodestarConnectionSource).
Koneksi dapat mengaitkan AWS sumber daya Anda dengan repositori pihak ketiga berikut:
+ Bitbucket Cloud (melalui opsi penyedia **Bitbucket** di CodePipeline konsol atau `Bitbucket` penyedia di CLI)
**catatan**
Anda dapat membuat koneksi ke repositori Bitbucket Cloud. Jenis penyedia Bitbucket yang diinstal, seperti Bitbucket Server, tidak didukung.
+
**catatan**
Jika Anda menggunakan ruang kerja Bitbucket, Anda harus memiliki akses administrator untuk membuat koneksi.
+ GitHub dan GitHub Enterprise Cloud (melalui opsi penyedia **GitHub (melalui GitHub Aplikasi)** di CodePipeline konsol atau `GitHub` penyedia di CLI)
**catatan**
Jika repositori Anda ada di GitHub organisasi, Anda harus menjadi pemilik organisasi untuk membuat koneksi. Jika Anda menggunakan repositori yang tidak ada dalam organisasi, Anda harus menjadi pemilik repositori.
+ GitHub Server Perusahaan (melalui opsi penyedia **Server GitHub Perusahaan** di CodePipeline konsol atau `GitHub Enterprise Server` penyedia di CLI)
+ GitLab.com (melalui opsi **GitLab**penyedia di CodePipeline konsol atau `GitLab` penyedia di CLI)
**catatan**
Anda dapat membuat koneksi ke repositori tempat Anda memiliki peran **Pemilik** GitLab, dan kemudian koneksi dapat digunakan dengan repositori dengan sumber daya seperti. CodePipeline Untuk repositori dalam grup, Anda tidak perlu menjadi pemilik grup.
+ Instalasi yang dikelola sendiri untuk GitLab (Edisi Perusahaan atau Edisi Komunitas) (melalui opsi penyedia yang **GitLab dikelola sendiri** di CodePipeline konsol atau `GitLabSelfManaged` penyedia di CLI)
**catatan**
Setiap koneksi mendukung semua repositori yang Anda miliki dengan penyedia itu. Anda hanya perlu membuat koneksi baru untuk setiap jenis penyedia.
Koneksi memungkinkan pipeline Anda mendeteksi perubahan sumber melalui aplikasi penginstalan penyedia pihak ketiga. Misalnya, webhook digunakan untuk berlangganan jenis GitHub acara dan dapat diinstal pada organisasi, repositori, atau Aplikasi. GitHub Koneksi Anda menginstal webhook repositori di GitHub Aplikasi Anda yang berlangganan peristiwa jenis push. GitHub
Setelah perubahan kode terdeteksi, Anda memiliki opsi berikut untuk meneruskan kode ke tindakan selanjutnya:
+ Default: Seperti tindakan CodePipeline sumber lain yang ada, `CodeStarSourceConnection` dapat menampilkan file ZIP dengan salinan dangkal dari komit Anda.
+ Klon lengkap: juga `CodeStarSourceConnection` dapat dikonfigurasi untuk menampilkan referensi URL ke repo 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.
CodePipeline meminta Anda untuk menambahkan aplikasi penginstalan AWS Konektor ke akun pihak ketiga saat Anda membuat koneksi. Anda harus sudah membuat akun dan repositori penyedia pihak ketiga Anda sebelum Anda dapat terhubung melalui tindakan. `CodeStarSourceConnection`
**catatan**
Untuk membuat atau melampirkan kebijakan ke peran Anda dengan izin yang diperlukan untuk menggunakan AWS CodeStar koneksi, lihat Referensi [izin koneksi](https://docs.aws.amazon.com/dtconsole/latest/userguide/security-iam.html#permissions-reference-connections). Bergantung pada kapan peran CodePipeline layanan dibuat, Anda mungkin perlu memperbarui izinnya untuk mendukung AWS CodeStar koneksi. Untuk petunjuk, lihat [Menambahkan izin ke peran CodePipeline layanan](how-to-custom-role.md#how-to-update-role-new-services).
**catatan**
Untuk menggunakan koneksi di Eropa (Milan) Wilayah AWS, Anda harus:
Instal aplikasi khusus Wilayah
Aktifkan Wilayah
Aplikasi khusus Wilayah ini mendukung koneksi di Wilayah Eropa (Milan). Ini diterbitkan di situs penyedia pihak ketiga, dan terpisah dari aplikasi yang ada yang mendukung koneksi untuk Wilayah lain. Dengan menginstal aplikasi ini, Anda memberi wewenang kepada penyedia pihak ketiga untuk membagikan data Anda dengan layanan untuk Wilayah ini saja, dan Anda dapat mencabut izin kapan saja dengan mencopot pemasangan aplikasi.
Layanan tidak akan memproses atau menyimpan data Anda kecuali Anda mengaktifkan Wilayah. Dengan mengaktifkan Wilayah ini, Anda memberikan izin layanan kami untuk memproses dan menyimpan data Anda.
Meskipun Wilayah tidak diaktifkan, penyedia pihak ketiga masih dapat membagikan data Anda dengan layanan kami jika aplikasi khusus Wilayah tetap diinstal, jadi pastikan untuk menghapus instalan aplikasi setelah Anda menonaktifkan Wilayah. Untuk informasi selengkapnya, lihat [Mengaktifkan Wilayah](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable).
**Topics**
+ [Tipe tindakan](#action-reference-CodestarConnectionSource-type)
+ [Parameter konfigurasi](#action-reference-CodestarConnectionSource-config)
+ [Artefak masukan](#action-reference-CodestarConnectionSource-input)
+ [Artefak keluaran](#action-reference-CodestarConnectionSource-output)
+ [Variabel keluaran](#action-reference-CodestarConnectionSource-variables)
+ [Izin peran layanan: tindakan CodeConnections](#edit-role-connections)
+ [Deklarasi tindakan](#action-reference-CodestarConnectionSource-example)
+ [Menginstal aplikasi instalasi dan membuat koneksi](#action-reference-CodestarConnectionSource-auth)
+ [Lihat juga](#action-reference-CodestarConnectionSource-links)
## Tipe tindakan
+ Kategori: `Source`
+ Pemilik: `AWS`
+ Penyedia: `CodeStarSourceConnection`
+ Versi: `1`
## Parameter konfigurasi
****ConnectionArn****
Wajib: Ya
Koneksi ARN yang dikonfigurasi dan diautentikasi untuk penyedia sumber.
****FullRepositoryId****
Wajib: Ya
Pemilik dan nama repositori tempat perubahan sumber dideteksi.
Contoh: `some-user/my-repo`
Anda harus mempertahankan kasus yang benar untuk **FullRepositoryId**nilainya. Misalnya, jika nama pengguna Anda `some-user` dan nama repo adalah`My-Repo`, nilai yang disarankan **FullRepositoryId**adalah`some-user/My-Repo`.
****BranchName****
Wajib: Ya
Nama cabang tempat perubahan sumber harus dideteksi.
****OutputArtifactFormat****
Wajib: Tidak
Menentukan format artefak keluaran. Bisa salah satu `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 memperbarui izin untuk peran layanan CodeBuild proyek Anda seperti yang ditunjukkan pada[Tambahkan CodeBuild GitClone izin untuk koneksi ke Bitbucket,, GitHub Enterprise Server GitHub, atau .com GitLab](troubleshooting.md#codebuild-role-connections). Untuk tutorial yang menunjukkan cara menggunakan opsi **klon Penuh**, lihat[Tutorial: Gunakan klon lengkap dengan sumber GitHub pipa](tutorials-github-gitclone.md).
**DetectChanges**
Wajib: Tidak
Kontrol secara otomatis memulai pipeline Anda ketika komit baru dibuat pada repositori dan cabang yang dikonfigurasi. Jika tidak ditentukan, nilai default adalah`true`, dan bidang tidak ditampilkan secara default. Nilai yang valid untuk parameter ini:
+ `true`: CodePipeline secara otomatis memulai pipeline Anda pada komit baru.
+ `false`: CodePipeline tidak memulai pipeline Anda pada komit baru.
## Artefak masukan
+ **Jumlah artefak:** `0`
+ **Deskripsi:** Artefak masukan tidak berlaku untuk jenis tindakan ini.
## Artefak keluaran
+ **Jumlah artefak:** `1`
+ **Deskripsi:** Artefak yang dihasilkan dari repositori adalah artefak keluaran untuk tindakan tersebut. `CodeStarSourceConnection` ID komit kode sumber ditampilkan CodePipeline sebagai revisi sumber untuk eksekusi pipeline yang dipicu. Anda dapat mengonfigurasi artefak keluaran dari tindakan ini di:
+ File ZIP yang berisi isi repositori dan cabang yang dikonfigurasi pada komit yang ditentukan sebagai revisi sumber untuk eksekusi pipeline.
+ File JSON yang berisi referensi URL ke repositori sehingga tindakan hilir dapat melakukan perintah Git secara langsung.
**penting**
Opsi ini hanya dapat digunakan oleh tindakan CodeBuild hilir.
Jika Anda memilih opsi ini, Anda perlu memperbarui izin untuk peran layanan CodeBuild proyek Anda seperti yang ditunjukkan pada[Pemecahan masalah CodePipeline](troubleshooting.md). Untuk tutorial yang menunjukkan cara menggunakan opsi **klon Penuh**, lihat[Tutorial: Gunakan klon lengkap dengan sumber GitHub pipa](tutorials-github-gitclone.md).
## 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).
AuthorDate
Tanggal ketika komit ditulis, dalam format stempel waktu.
BranchName
Nama cabang untuk repositori tempat perubahan sumber dilakukan.
CommitId
ID komit yang memicu eksekusi pipeline.
CommitMessage
Pesan deskripsi, jika ada, terkait dengan komit yang memicu eksekusi pipeline.
ConnectionArn
Koneksi ARN yang dikonfigurasi dan diautentikasi untuk penyedia sumber.
FullRepositoryName
Nama repositori tempat komit yang memicu pipeline dibuat.
## Izin peran layanan: tindakan CodeConnections
Untuk CodeConnections, izin berikut diperlukan untuk membuat pipeline dengan sumber yang menggunakan koneksi, seperti Bitbucket Cloud.
```
{
"Effect": "Allow",
"Action": [
"codeconnections:UseConnection"
],
"Resource": "resource_ARN"
},
```
Untuk informasi selengkapnya tentang izin IAM untuk koneksi, lihat Referensi [izin koneksi](https://docs.aws.amazon.com/dtconsole/latest/userguide/security-iam.html#permissions-reference-connections).
## Deklarasi tindakan
Dalam contoh berikut, artefak keluaran diatur ke format ZIP default `CODE_ZIP` untuk koneksi dengan ARN`arn:aws:codestar-connections:region:account-id:connection/connection-id`.
------
#### [ YAML ]
```
Name: Source
Actions:
- InputArtifacts: []
ActionTypeId:
Version: '1'
Owner: AWS
Category: Source
Provider: CodeStarSourceConnection
OutputArtifacts:
- Name: SourceArtifact
RunOrder: 1
Configuration:
ConnectionArn: "arn:aws:codestar-connections:region:account-id:connection/connection-id"
FullRepositoryId: "some-user/my-repo"
BranchName: "main"
OutputArtifactFormat: "CODE_ZIP"
Name: ApplicationSource
```
------
#### [ JSON ]
```
{
"Name": "Source",
"Actions": [
{
"InputArtifacts": [],
"ActionTypeId": {
"Version": "1",
"Owner": "AWS",
"Category": "Source",
"Provider": "CodeStarSourceConnection"
},
"OutputArtifacts": [
{
"Name": "SourceArtifact"
}
],
"RunOrder": 1,
"Configuration": {
"ConnectionArn": "arn:aws:codestar-connections:region:account-id:connection/connection-id",
"FullRepositoryId": "some-user/my-repo",
"BranchName": "main",
"OutputArtifactFormat": "CODE_ZIP"
},
"Name": "ApplicationSource"
}
]
},
```
------
## Menginstal aplikasi instalasi dan membuat koneksi
Pertama kali Anda menggunakan konsol untuk menambahkan koneksi baru ke repositori pihak ketiga, Anda harus mengotorisasi CodePipeline akses ke repositori Anda. Anda memilih atau membuat aplikasi instalasi yang membantu Anda terhubung ke akun tempat Anda membuat repositori kode pihak ketiga.
Ketika Anda menggunakan AWS CLI atau CloudFormation template, Anda harus menyediakan koneksi ARN dari koneksi yang telah melalui jabat tangan instalasi. Jika tidak, pipa tidak dipicu.
**catatan**
Untuk tindakan `CodeStarSourceConnection` sumber, Anda tidak perlu menyiapkan webhook atau default ke polling. Tindakan koneksi mengelola deteksi perubahan sumber Anda untuk Anda.
## Lihat juga
Sumber daya terkait berikut dapat membantu Anda saat Anda bekerja dengan tindakan ini.
+ [AWS::CodeStarConnections::Connection](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-codestarconnections-connection.html)— Referensi CloudFormation template untuk sumber daya AWS CodeStar Connections menyediakan parameter dan contoh untuk koneksi dalam CloudFormation template.
+ [AWS CodeStarReferensi API AWS](https://docs.aws.amazon.com/codestar-connections/latest/APIReference/Welcome.html) * CodeStar Koneksi — Referensi API Koneksi* menyediakan informasi referensi untuk tindakan koneksi yang tersedia.
+ Untuk melihat langkah-langkah untuk membuat pipeline dengan tindakan sumber yang didukung oleh koneksi, lihat berikut ini:
+ Untuk Bitbucket Cloud, gunakan opsi **Bitbucket** di konsol atau `CodestarSourceConnection` tindakan di CLI. Lihat [Koneksi Bitbucket Cloud](connections-bitbucket.md).
+ Untuk GitHub dan GitHub Enterprise Cloud, gunakan opsi **GitHub**penyedia di konsol atau `CodestarSourceConnection` tindakan di CLI. Lihat [GitHub koneksi](connections-github.md).
+ Untuk GitHub Enterprise Server, gunakan opsi penyedia **GitHub Enterprise Server** di konsol atau `CodestarSourceConnection` tindakan di CLI. Lihat [GitHub Koneksi Enterprise Server](connections-ghes.md).
+ GitLabUntuk.com, gunakan opsi **GitLab**penyedia di konsol atau `CodestarSourceConnection` tindakan dengan `GitLab` penyedia di CLI. Lihat [GitLabkoneksi .com](connections-gitlab.md).
+ Untuk melihat tutorial Memulai yang membuat pipeline dengan sumber Bitbucket dan CodeBuild tindakan, lihat [Memulai koneksi](https://docs.aws.amazon.com/dtconsole/latest/userguide/getting-started-connections.html).
+ Untuk tutorial yang menunjukkan cara menghubungkan ke GitHub repositori dan menggunakan opsi **klon Penuh** dengan tindakan hilir CodeBuild , lihat. [Tutorial: Gunakan klon lengkap dengan sumber GitHub pipa](tutorials-github-gitclone.md)