Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Langkah-langkah penyiapan untuk koneksi HTTPS ke AWS CodeCommit dengan git-remote-codecommit
Jika Anda ingin terhubung CodeCommit menggunakan akun root, akses federasi, atau kredensi sementara, Anda harus mengatur akses menggunakan. **git-remote-codecommit** Utilitas ini menyediakan metode sederhana untuk mendorong dan menarik kode dari CodeCommit repositori dengan memperluas Git. Ini adalah metode yang direkomendasikan untuk mendukung koneksi yang dibuat dengan akses gabungan, penyedia identitas, dan kredensial sementara. Untuk menetapkan izin ke identitas federasi, Anda membuat peran dan menentukan izin untuk peran tersebut. Ketika identitas terfederasi mengautentikasi, identitas tersebut terhubung dengan peran dan diberi izin yang ditentukan oleh peran. Untuk informasi tentang peran untuk federasi, lihat [Buat peran untuk penyedia identitas pihak ketiga](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp.html) dalam *Panduan Pengguna IAM*. Jika menggunakan Pusat Identitas IAM, Anda harus mengonfigurasi set izin. Untuk mengontrol apa yang dapat diakses identitas Anda setelah identitas tersebut diautentikasi, Pusat Identitas IAM akan mengorelasikan set izin ke peran dalam IAM. Untuk informasi tentang set izin, lihat [Set izin](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html) dalam *Panduan Pengguna AWS IAM Identity Center *.
Anda juga dapat menggunakan **git-remote-codecommit** dengan pengguna IAM. Tidak seperti metode koneksi HTTPS lainnya, **git-remote-codecommit** tidak memerlukan pengaturan kredensial Git untuk pengguna.
**catatan**
Beberapa IDEs tidak mendukung format URL klon yang digunakan oleh`git-remote-codecommit`. Anda mungkin harus secara manual mengkloning repositori ke komputer lokal Anda sebelum Anda dapat bekerja dengan repositori di IDE yang Anda pilih. Untuk informasi selengkapnya, lihat [Pemecahan masalah git-remote-codecommit dan AWS CodeCommit](troubleshooting-grc.md).
Prosedur ini ditulis dengan asumsi bahwa Anda memiliki akun Amazon Web Services, telah membuat setidaknya satu repositori di CodeCommit, dan menggunakan pengguna IAM dengan kebijakan terkelola saat menghubungkan ke repositori. CodeCommit Untuk informasi tentang cara mengkonfigurasi akses untuk pengguna gabungan dan jenis kredensial berputar lainnya, lihat [Menghubungkan ke AWS CodeCommit repositori dengan kredensi berputar](temporary-access.md).
**Topics**
+ [Langkah 0: Instal prasyarat untuk git-remote-codecommit](#setting-up-git-remote-codecommit-prereq)
+ [Langkah 1: Konfigurasi awal untuk CodeCommit](#setting-up-git-remote-codecommit-account)
+ [Langkah 2: Instal git-remote-codecommit](#setting-up-git-remote-codecommit-install)
+ [Langkah 3: Connect ke CodeCommit konsol dan kloning repositori](#setting-up-git-remote-codecommit-connect-console)
+ [Langkah selanjutnya](#setting-up-git-remote-codecommit-next-step)
## Langkah 0: Instal prasyarat untuk git-remote-codecommit
Sebelum Anda dapat menggunakan **git-remote-codecommit**, Anda harus menginstal beberapa prasyarat di komputer lokal Anda. Ini termasuk:
+ Versi Python yang didukung. Untuk informasi selengkapnya tentang versi Python yang didukung, lihat. [git-remote-codecommit](https://pypi.org/project/git-remote-codecommit/)
Untuk informasi selengkapnya tentang pengaturan dan penggunaan git-remote-codecommit, lihat[Langkah-langkah penyiapan untuk koneksi HTTPS ke AWS CodeCommit dengan git-remote-codecommit](#setting-up-git-remote-codecommit).
+ Git
**catatan**
Ketika Anda menginstal Python pada Windows, pastikan bahwa Anda memilih opsi untuk menambahkan Python ke path.
**git-remote-codecommit** memerlukan pip versi 9.0.3 atau versi lebih baru. Untuk memeriksa versi pip Anda, buka terminal atau baris perintah dan jalankan perintah berikut:
```
pip --version
```
Anda dapat menjalankan dua perintah berikut untuk memperbarui versi pip Anda ke versi terbaru:
```
curl -O https://bootstrap.pypa.io/get-pip.py
python3 get-pip.py --user
```
Untuk bekerja dengan file, commit, dan informasi lainnya di CodeCommit repositori, Anda harus menginstal Git pada mesin lokal Anda. CodeCommit mendukung Git versi 1.7.9 dan yang lebih baru. Versi Git 2.28 mendukung konfigurasi nama cabang untuk commit awal. Kami menyarankan penggunaan versi terbaru Git.
Untuk menginstal Git, kami merekomendasikan situs web seperti [Pengunduhan Git](http://git-scm.com/downloads).
**catatan**
Git adalah platform yang berkembang dan diperbarui secara teratur. Terkadang, perubahan fitur dapat memengaruhi cara kerjanya CodeCommit. Jika Anda mengalami masalah dengan versi Git tertentu dan CodeCommit, tinjau informasinya di[Pemecahan Masalah](troubleshooting.md).
## Langkah 1: Konfigurasi awal untuk CodeCommit
Ikuti langkah-langkah untuk membuat pengguna IAM, mengkonfigurasi dengan kebijakan yang sesuai, mendapatkan access key dan secret key, dan menginstal dan mengkonfigurasi AWS CLI.
**Untuk membuat dan mengkonfigurasi pengguna IAM untuk mengakses CodeCommit**
1. Buat akun Amazon Web Services dengan membuka [http://aws.amazon.com](https://aws.amazon.com/) dan memilih **Mendaftar**.
1. Membuat pengguna IAM, atau menggunakan yang sudah ada, di akun Amazon Web Services Anda. Pastikan Anda memiliki access key ID dan secret access key yang terkait dengan pengguna IAM. Untuk informasi selengkapnya, lihat [Membuat pengguna IAM di akun Amazon Web Services Anda](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html).
**catatan**
CodeCommit membutuhkan AWS Key Management Service. Jika Anda menggunakan pengguna IAM yang sudah ada, pastikan tidak ada kebijakan yang dilampirkan pada pengguna yang secara tegas menolak AWS KMS tindakan yang diperlukan oleh. CodeCommit Untuk informasi selengkapnya, lihat [AWS KMS dan enkripsi](encryption.md).
1. Masuk ke Konsol Manajemen AWS dan buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Di konsol IAM, di panel navigasi, pilih Pengguna, lalu pilih **pengguna** IAM yang ingin Anda konfigurasikan untuk akses. CodeCommit
1. Pada tab **Izin**, pilih **Tambahkan izin**.
1. Dalam **Berikan izin**, pilih **Lampirkan kebijakan yang ada secara langsung**.
1. Dari daftar kebijakan, pilih **AWSCodeCommitPowerUser**atau kebijakan terkelola lainnya untuk CodeCommit akses. Untuk informasi selengkapnya, lihat [AWS kebijakan terkelola untuk CodeCommit](security-iam-awsmanpol.md).
Setelah memilih kebijakan yang ingin dilampirkan, pilih **Berikutnya: Tinjau** untuk meninjau daftar kebijakan untuk dilampirkan ke pengguna IAM. Jika daftar sudah benar, pilih **Tambahkan izin**.
Untuk informasi selengkapnya tentang kebijakan CodeCommit terkelola dan berbagi akses ke repositori dengan grup dan pengguna lain, lihat [Bagikan sebuah repositori](how-to-share-repository.md) dan. [Otentikasi dan kontrol akses untuk AWS CodeCommit](auth-and-access-control.md)
**Untuk menginstal dan mengkonfigurasi AWS CLI**
1. Di mesin lokal Anda, unduh dan instal file AWS CLI. Ini adalah prasyarat untuk berinteraksi dengan CodeCommit dari baris perintah. Kami merekomendasikan agar Anda menginstal AWS CLI versi 2. Ini adalah versi utama terbaru dari AWS CLI dan mendukung semua fitur terbaru. Ini adalah satu-satunya versi AWS CLI yang mendukung penggunaan akun root, akses federasi, atau kredensi sementara dengan. **git-remote-codecommit**
Untuk informasi selengkapnya, lihat [Menyiapkan dengan Antarmuka Baris AWS Perintah](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html).
**catatan**
CodeCommit hanya berfungsi dengan AWS CLI versi 1.7.38 dan yang lebih baru. Sebagai praktik terbaik, instal atau tingkatkan AWS CLI ke versi terbaru yang tersedia. Untuk menentukan versi mana yang telah AWS CLI Anda instal, jalankan **aws --version** perintah.
Untuk memutakhirkan versi yang lebih lama AWS CLI ke versi terbaru, lihat [Menginstal AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html).
1. Jalankan perintah ini untuk memverifikasi bahwa CodeCommit perintah AWS CLI untuk diinstal.
```
aws codecommit help
```
Perintah ini mengembalikan daftar CodeCommit perintah.
1. Konfigurasikan AWS CLI dengan profil dengan menggunakan **configure** perintah, sebagai berikut:.
```
aws configure
```
Saat diminta, tentukan kunci AWS akses dan kunci akses AWS rahasia pengguna IAM untuk digunakan. CodeCommit Juga, pastikan untuk menentukan di Wilayah AWS mana repositori ada, seperti. `us-east-2` Saat diminta untuk format output default, tentukan `json`. Misalnya, jika Anda mengonfigurasi profil untuk pengguna IAM:
```
AWS Access Key ID [None]: Type your IAM user AWS access key ID here, and then press Enter
AWS Secret Access Key [None]: Type your IAM user AWS secret access key here, and then press Enter
Default region name [None]: Type a supported region for CodeCommit here, and then press Enter
Default output format [None]: Type json here, and then press Enter
```
Untuk informasi selengkapnya tentang membuat dan mengonfigurasi profil yang akan digunakan AWS CLI, lihat berikut ini:
+ [Profil Bernama](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
+ [Menggunakan Peran IAM dalam AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-role.html)
+ [Tetapkan perintah](https://docs.aws.amazon.com/cli/latest/reference/set.html)
+ [Menghubungkan ke AWS CodeCommit repositori dengan kredensi berputar](temporary-access.md)
Untuk terhubung ke repositori atau sumber daya di tempat lain Wilayah AWS, Anda harus mengkonfigurasi ulang AWS CLI dengan nama Wilayah default. Nama Wilayah default yang didukung untuk CodeCommit menyertakan:
+ us-east-2
+ us-east-1
+ eu-west-1
+ us-west-2
+ ap-northeast-1
+ ap-southeast-1
+ ap-southeast-2
+ ap-southeast-3
+ me-central-1
+ eu-central-1
+ ap-northeast-2
+ sa-east-1
+ us-west-1
+ eu-west-2
+ ap-south-1
+ ap-south-1
+ ca-central-1
+ us-gov-west-1
+ us-gov-east-1
+ eu-north-1
+ ap-east-1
+ me-south-1
+ cn-north-1
+ cn-northwest-1
+ eu-south-1
+ ap-northeast-3
+ af-south-1
+ il-central-1
Untuk informasi lebih lanjut tentang CodeCommit dan Wilayah AWS, lihat[Wilayah dan titik akhir koneksi Git](regions.md). Untuk informasi selengkapnya tentang IAM, access key, dan kunci rahasia, lihat [Bagaimana Saya Mendapatkan Kredensials?](https://docs.aws.amazon.com/IAM/latest/UserGuide/IAM_Introduction.html#IAM_SecurityCredentials) dan [Mengelola Access Key untuk Pengguna IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingCredentials.html). Untuk informasi selengkapnya tentang profil AWS CLI dan profil, lihat [Profil Bernama](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html).
## Langkah 2: Instal git-remote-codecommit
Ikuti langkah-langkah berikut untuk menginstal **git-remote-codecommit**.
**Untuk menginstal git-remote-codecommit**
1. Pada terminal atau baris perintah, jalankan perintah berikut:
```
pip install git-remote-codecommit
```
**catatan**
Bergantung pada sistem operasi dan konfigurasi Anda, Anda mungkin perlu menjalankan perintah ini dengan izin tinggi, seperti sudo, atau menggunakan parameter --user untuk menginstal ke direktori yang tidak memerlukan hak istimewa khusus, seperti akun pengguna Anda saat ini. Misalnya, pada komputer yang menjalankan Linux, macOS, atau Unix:
```
sudo pip install git-remote-codecommit
```
Di komputer yang menjalankan Windows:
```
pip install --user git-remote-codecommit
```
1. Pantau proses instalasi sampai Anda melihat pesan sukses.
## Langkah 3: Connect ke CodeCommit konsol dan kloning repositori
Jika administrator telah mengirimi Anda URL klon untuk digunakan untuk CodeCommit repositori, Anda dapat melewati koneksi ke konsol dan mengkloning repositori secara langsung. **git-remote-codecommit**
**Untuk terhubung ke CodeCommit repositori**
1. Buka CodeCommit konsol di [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home).
1. Di pemilih wilayah, pilih Wilayah AWS tempat repositori dibuat. Repositori khusus untuk file. Wilayah AWS Untuk informasi selengkapnya, lihat [Wilayah dan titik akhir koneksi Git](regions.md).
1. Temukan repositori yang ingin Anda sambungkan dari daftar dan pilih. Pilih **URL Kloning**, lalu pilih protokol yang ingin Anda gunakan saat mengkloning atau menghubungkan ke repositori. Langkah ini akan menyalin URL klon tersebut.
+ Salin URL HTTPS jika Anda menggunakan kredensial Git dengan pengguna IAM Anda atau pembantu kredensial yang disertakan dengan AWS CLI.
+ Salin URL HTTPS (GRC) jika Anda menggunakan perintah **git-remote-codecommit** di komputer lokal Anda.
+ Salin URL SSH jika Anda menggunakan public/private key pair SSH dengan pengguna IAM Anda.
**catatan**
Jika Anda melihat halaman **Selamat Datang** alih-alih daftar repositori, tidak ada repositori yang terkait dengan AWS akun Anda di Wilayah AWS tempat Anda masuk. Untuk membuat repositori, lihat [Buat AWS CodeCommit repositori](how-to-create-repository.md) atau ikuti langkah-langkah di tutorial [Memulai dengan Git dan CodeCommit](getting-started.md).
1. Di terminal atau command prompt, kloning repositori dengan perintah **git clone**. Gunakan git-remote-codecommit URL HTTPS yang Anda salin dan nama AWS CLI profil, jika Anda membuat profil bernama. Jika Anda tidak menentukan profil, perintah mengasumsikan profil default. Repo lokal dibuat di subdirektori direktori di mana Anda menjalankan perintah. Misalnya, untuk mengkloning repositori bernama *MyDemoRepo* repo lokal bernama: *my-demo-repo*
```
git clone codecommit://MyDemoRepo my-demo-repo
```
Untuk mengkloning repositori yang sama menggunakan profil bernama: *CodeCommitProfile*
```
git clone codecommit://CodeCommitProfile@MyDemoRepo my-demo-repo
```
Untuk mengkloning repositori yang berbeda Wilayah AWS dari yang dikonfigurasi di profil Anda, sertakan namanya. Wilayah AWS Contoh:
```
git clone codecommit::ap-northeast-1://MyDemoRepo my-demo-repo
```
## Langkah selanjutnya
Anda telah menyelesaikan prasyaratnya. Ikuti langkah-langkahnya [Memulai dengan CodeCommit ](getting-started-cc.md) untuk mulai menggunakan CodeCommit.
Untuk mempelajari cara membuat dan mendorong commit pertama Anda, lihat [Buat komit di AWS CodeCommit](how-to-create-commit.md). Jika Anda baru mengenal Git, Anda mungkin juga ingin meninjau informasi di [Di mana saya dapat mempelajari lebih lanjut tentang Git?](welcome.md#welcome-get-started-with-git) dan [Memulai dengan Git dan AWS CodeCommit](getting-started.md).