Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# GitHub koneksi
Anda menggunakan koneksi untuk mengotorisasi dan membuat konfigurasi yang mengaitkan penyedia pihak ketiga Anda dengan sumber daya Anda AWS .
**catatan**
Alih-alih membuat atau menggunakan koneksi yang ada di akun Anda, Anda dapat menggunakan koneksi bersama antara yang lain Akun AWS. Lihat [Menggunakan koneksi yang dibagikan dengan akun lain](connections-shared.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.md).
Untuk menambahkan tindakan sumber untuk repositori GitHub Enterprise Cloud Anda GitHub atau di CodePipeline, Anda dapat memilih salah satu untuk:
+ Gunakan wizard **Buat pipeline CodePipeline ** konsol atau halaman **tindakan Edit** untuk memilih opsi penyedia **GitHub (melalui GitHub Aplikasi)**. Lihat [Buat koneksi ke GitHub Enterprise Server (konsol)](connections-ghes.md#connections-ghes-console) untuk menambahkan tindakan. Konsol membantu Anda membuat sumber daya koneksi.
**catatan**
Untuk tutorial yang memandu Anda melalui cara menambahkan GitHub koneksi dan menggunakan opsi **klon penuh di pipeline Anda untuk mengkloning** metadata, lihat. [Tutorial: Gunakan klon lengkap dengan sumber GitHub pipa](tutorials-github-gitclone.md)
+ Gunakan CLI untuk menambahkan konfigurasi tindakan untuk tindakan dengan `GitHub` penyedia dengan langkah-langkah CLI yang ditunjukkan di. `CodeStarSourceConnection` [Buat pipeline (CLI)](pipelines-create.md#pipelines-create-cli)
**catatan**
Anda juga dapat membuat koneksi menggunakan konsol Alat Pengembang di bawah **Pengaturan**. Lihat [Membuat Koneksi](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html).
Sebelum Anda memulai:
+ Anda harus telah membuat akun dengan GitHub.
+ Anda harus sudah membuat repositori GitHub kode.
+ Jika peran CodePipeline layanan Anda dibuat sebelum 18 Desember 2019, Anda mungkin perlu memperbarui izinnya untuk digunakan `codestar-connections:UseConnection` untuk 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 membuat koneksi, Anda harus menjadi pemilik GitHub organisasi. Untuk repositori yang tidak berada di bawah organisasi, Anda harus menjadi pemilik repositori.
**Topics**
+ [Buat koneksi ke GitHub (konsol)](#connections-github-console)
+ [Buat koneksi ke GitHub (CLI)](#connections-github-cli)
## Buat koneksi ke GitHub (konsol)
Gunakan langkah-langkah ini untuk menggunakan CodePipeline konsol guna menambahkan tindakan koneksi untuk repositori Cloud GitHub atau GitHub Enterprise Cloud Anda.
**catatan**
**Dalam langkah-langkah ini, Anda dapat memilih repositori tertentu di bawah Akses Repositori.** Repositori apa pun yang tidak dipilih tidak akan dapat diakses atau dilihat oleh. CodePipeline
### Langkah 1: Buat atau edit pipeline Anda
1. Masuk ke CodePipeline konsol.
1. Pilih salah satu dari berikut ini.
+ Pilih untuk membuat pipeline. Ikuti langkah-langkah di *Create a Pipeline* untuk menyelesaikan layar pertama dan pilih **Berikutnya**. Pada halaman **Sumber**, di bawah **Penyedia Sumber**, pilih **GitHub (melalui GitHub Aplikasi)**.
+ Pilih untuk mengedit pipeline yang ada. Pilih **Edit**, lalu pilih **Edit tahap**. Pilih untuk menambahkan atau mengedit tindakan sumber Anda. Pada halaman **Edit tindakan**, di bawah **Nama tindakan**, masukkan nama untuk tindakan Anda. Di **penyedia Tindakan**, pilih **GitHub (melalui GitHub Aplikasi)**.
1. Lakukan salah satu tindakan berikut:
+ Di bawah **Koneksi**, jika Anda belum membuat sambungan ke penyedia Anda, pilih **Connect to GitHub**. Lanjutkan ke Langkah 2: Buat Koneksi ke GitHub.
+ Di bawah **Koneksi**, jika Anda telah membuat koneksi ke penyedia Anda, pilih koneksi. Lanjutkan ke Langkah 3: Simpan tindakan sumber untuk koneksi Anda.
### Langkah 2: Buat koneksi ke GitHub
Setelah Anda memilih untuk membuat koneksi, GitHub halaman **Connect to akan** muncul.
![\[Tangkapan layar konsol yang menunjukkan halaman GitHub koneksi awal.\]](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/images/github-conn.png)
**Untuk membuat koneksi ke GitHub**
1. Di bawah **pengaturan GitHub koneksi**, nama koneksi Anda muncul di **Nama koneksi**. Pilih **Connect to GitHub**. Halaman permintaan akses muncul.
1. Pilih **Otorisasi AWS Konektor untuk GitHub**. Halaman koneksi menampilkan dan menampilkan bidang **GitHub Aplikasi**.
![\[Tangkapan layar konsol yang menampilkan halaman GitHub koneksi awal dengan bidang GitHub Aplikasi.\]](http://docs.aws.amazon.com/id_id/codepipeline/latest/userguide/images/github-conn-access-app.png)
1. Di bawah **GitHub Aplikasi**, pilih penginstalan aplikasi atau pilih **Instal aplikasi baru** untuk membuatnya.
Anda menginstal satu aplikasi untuk semua koneksi Anda ke penyedia tertentu. Jika Anda telah menginstal AWS Connector for GitHub app, pilih dan lewati langkah ini.
**catatan**
Jika Anda ingin membuat [token akses pengguna](https://docs.github.com/en/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app), pastikan Anda telah menginstal AWS Connector for GitHub app lalu biarkan bidang Instalasi aplikasi kosong. CodeConnections akan menggunakan token akses pengguna untuk koneksi.
1. Pada GitHub halaman **Install AWS Connector for**, pilih akun tempat Anda ingin menginstal aplikasi.
**catatan**
Anda hanya menginstal aplikasi sekali untuk setiap GitHub akun. Jika sebelumnya Anda menginstal aplikasi, Anda dapat memilih **Konfigurasi** untuk melanjutkan ke halaman modifikasi untuk instalasi aplikasi Anda, atau Anda dapat menggunakan tombol kembali untuk kembali ke konsol.
1. **Pada GitHub halaman **Install AWS Connector for**, tinggalkan default, dan pilih Install.**
1. Pada GitHub halaman **Connect to**, ID koneksi untuk instalasi baru Anda muncul di **GitHub Aplikasi**. Pilih **Hubungkan**.
### Langkah 3: Simpan tindakan GitHub sumber Anda
Gunakan langkah-langkah ini di halaman **Edit tindakan** untuk menyimpan tindakan sumber Anda dengan informasi koneksi Anda.
**Untuk menyimpan tindakan GitHub sumber Anda**
1. Dalam nama **Repositori, pilih nama** repositori pihak ketiga Anda.
1. Di bawah **pemicu Pipeline**, Anda dapat menambahkan pemicu jika tindakan Anda adalah CodeConnections tindakan. Untuk mengonfigurasi konfigurasi pemicu pipeline dan memfilter secara opsional dengan pemicu, lihat detail selengkapnya di. [Tambahkan pemicu dengan tipe acara permintaan push atau pull kode](pipelines-filter.md)
1. Dalam **format artefak Output**, Anda harus memilih format untuk artefak Anda.
+ Untuk menyimpan artefak keluaran dari GitHub tindakan menggunakan metode default, pilih **CodePipeline default**. Tindakan mengakses file dari GitHub repositori dan menyimpan artefak dalam file ZIP di toko artefak pipa.
+ **Untuk menyimpan file JSON yang berisi referensi URL ke repositori sehingga tindakan hilir dapat melakukan perintah Git secara langsung, pilih klon Penuh.** 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).
1. Pilih **Berikutnya** di wizard atau **Simpan** di halaman **Edit tindakan**.
## Buat koneksi ke GitHub (CLI)
Anda dapat menggunakan AWS Command Line Interface (AWS CLI) untuk membuat koneksi.
Untuk melakukannya, gunakan perintah **create-connection**.
**penting**
Koneksi yang dibuat melalui AWS CLI atau AWS CloudFormation dalam `PENDING` status secara default. Setelah Anda membuat koneksi dengan CLI atau CloudFormation, gunakan konsol untuk mengedit koneksi untuk membuat statusnya. `AVAILABLE`
**Untuk membuat koneksi**
1. Buka terminal (Linux, macOS, atau Unix) atau command prompt (Windows). Gunakan AWS CLI untuk menjalankan **create-connection** perintah, menentukan `--provider-type` dan `--connection-name` untuk koneksi Anda. Dalam contoh ini, nama penyedia pihak ketiga adalah `GitHub` dan nama koneksi yang ditentukan adalah `MyConnection`.
```
aws codestar-connections create-connection --provider-type GitHub --connection-name MyConnection
```
Jika berhasil, perintah ini mengembalikan informasi ARN koneksi seperti berikut ini.
```
{
"ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
}
```
1. Gunakan konsol untuk menyelesaikan koneksi. Untuk informasi selengkapnya, lihat [Memperbarui sambungan yang tertunda](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-update.html).
1. Pipeline default untuk mendeteksi perubahan pada push kode ke repositori sumber koneksi. Untuk mengonfigurasi konfigurasi pemicu pipeline untuk rilis manual atau untuk tag Git, lakukan salah satu hal berikut:
+ Untuk mengonfigurasi konfigurasi pemicu pipeline untuk memulai dengan rilis manual saja, tambahkan baris berikut ke konfigurasi:
```
"DetectChanges": "false",
```
+ 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). Misalnya, berikut ini menambah tingkat pipa definisi JSON pipa. Dalam contoh ini, `release-v0` dan `release-v1` merupakan tag Git untuk disertakan, dan `release-v2` merupakan tag Git untuk dikecualikan.
```
"triggers": [
{
"providerType": "CodeStarSourceConnection",
"gitConfiguration": {
"sourceActionName": "Source",
"push": [
{
"tags": {
"includes": [
"release-v0", "release-v1"
],
"excludes": [
"release-v2"
]
}
}
]
}
}
]
```