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 repositori di Linux, macOS, atau Unix dengan pembantu kredensi AWS CLI
Sebelum Anda dapat terhubung AWS CodeCommit untuk pertama kalinya, Anda harus menyelesaikan langkah-langkah konfigurasi awal. Bagi sebagian besar pengguna, ini bisa dilakukan dengan mudah dengan mengikuti langkah-langkah di [Untuk pengguna HTTPS menggunakan kredensials Git](setting-up-gc.md). Namun, jika Anda ingin terhubung CodeCommit menggunakan akun root, akses federasi, atau kredenal sementara, Anda dapat menggunakan pembantu kredenal yang disertakan dalam file. AWS CLI
**catatan**
Meskipun pembantu kredenal adalah metode yang didukung untuk menghubungkan CodeCommit menggunakan akses federasi, penyedia identitas, atau kredensi sementara, metode yang disarankan adalah menginstal dan menggunakan utilitas. **git-remote-codecommit** Untuk informasi selengkapnya, lihat [Langkah-langkah penyiapan untuk koneksi HTTPS ke AWS CodeCommit dengan git-remote-codecommit](setting-up-git-remote-codecommit.md).
**Topics**
+ [Langkah 1: Konfigurasi awal untuk CodeCommit](#setting-up-https-unixes-account)
+ [Langkah 2: Instal Git](#setting-up-https-unixes-install-git)
+ [Langkah 3: Mengatur pembantu kredensial](#setting-up-https-unixes-credential-helper)
+ [Langkah 4: Hubungkan ke CodeCommit konsol dan kloning repositori](#setting-up-https-unixes-connect-console)
+ [Langkah selanjutnya](#setting-up-https-unixes-next-step)
## Langkah 1: Konfigurasi awal untuk CodeCommit
Ikuti langkah-langkah untuk mengatur akun Amazon Web Services, membuat dan mengkonfigurasi IAM pengguna, dan menginstal 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
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 3: Mengatur pembantu kredensial
1. Dari terminal, gunakan Git untuk menjalankan**git config**, menentukan penggunaan pembantu kredenal Git dengan profil kredensialnya, dan memungkinkan pembantu AWS kredensi Git untuk mengirim jalur ke repositori:
```
git config --global credential.helper '!aws codecommit credential-helper $@'
git config --global credential.UseHttpPath true
```
**Tip**
Pembantu kredenal menggunakan profil AWS kredensi default atau peran instans Amazon EC2. Anda dapat menentukan profil yang akan digunakan, seperti`CodeCommitProfile`, jika Anda telah membuat profil AWS kredensi untuk digunakan dengan CodeCommit:
```
git config --global credential.helper '!aws --profile CodeCommitProfile codecommit credential-helper $@'
```
Jika nama profil Anda berisi spasi, pastikan Anda menyertakan nama dalam tanda kutip (").
Anda dapat mengkonfigurasi profil per repositori bukan secara global dengan menggunakan `--local` bukan `--global`.
Pembantu kredensial Git menulis nilai berikut ke `~/.gitconfig`:
```
[credential]
helper = !aws --profile CodeCommitProfile codecommit credential-helper $@
UseHttpPath = true
```
**penting**
Jika Anda ingin menggunakan pengguna IAM yang berbeda pada mesin lokal yang sama untuk CodeCommit, Anda harus menjalankan **git config** perintah lagi dan menentukan profil AWS kredensi yang berbeda.
1. Jalankan **git config --global --edit** untuk memverifikasi nilai sebelumnya telah ditulis ke `~/.gitconfig`. Jika berhasil, Anda akan melihat nilai-nilai sebelumnya (selain nilai-nilai yang mungkin sudah ada di file konfigurasi global Git). Untuk keluar, biasanya Anda akan mengetik **:q**, lalu tekan Enter.
Jika Anda mengalami masalah setelah Anda mengkonfigurasi pembantu kredensial Anda, lihat [Pemecahan Masalah](troubleshooting.md).
**penting**
Jika Anda menggunakan macOS, gunakan langkah-langkah berikut untuk memastikan pembantu kredensial dikonfigurasi dengan benar.
1. Jika Anda menggunakan macOS, gunakan HTTPS untuk [terhubung ke repositori](how-to-connect.md). CodeCommit Setelah Anda terhubung ke CodeCommit repositori dengan HTTPS untuk pertama kalinya, akses berikutnya gagal setelah sekitar 15 menit. Versi Git default di macOS menggunakan utilitas Keychain Access untuk menyimpan kredensial. Untuk langkah-langkah keamanan, kata sandi yang dihasilkan untuk akses ke CodeCommit repositori Anda bersifat sementara, sehingga kredensi yang disimpan di gantungan kunci berhenti berfungsi setelah sekitar 15 menit. Untuk mencegah kredensial kedaluwarsa ini digunakan, Anda harus:
+ Menginstal versi Git yang tidak menggunakan keychain secara default.
+ Konfigurasikan utilitas Akses Rantai Kunci untuk tidak memberikan kredensi untuk repositori. CodeCommit
1. Buka utilitas Keychain Access. (Anda dapat menggunakan Finder untuk menemukannya.)
1. Cari `git-codecommit.us-east-2.amazonaws.com`. Sorot baris, buka menu konteks atau klik kanan, lalu pilih **Dapatkan Info**.
1. Pilih tab **Kontrol akses**.
1. Dalam **Konfirmasi sebelum mengizinkan akses**, pilih `git-credential-osxkeychain`, lalu pilih tanda minus untuk menghapusnya dari daftar.
**catatan**
Setelah menghapus `git-credential-osxkeychain` dari daftar, Anda melihat pesan pop-up setiap kali Anda menjalankan perintah Git. Pilih **Tolak** untuk melanjutkan. Jika menurut Anda pop-up terlalu mengganggu, berikut adalah beberapa pilihan lainnya:
Connect untuk CodeCommit menggunakan SSH, bukan HTTPS. Untuk informasi selengkapnya, lihat [Untuk koneksi SSH di Linux, macOS, atau Unix](setting-up-ssh-unixes.md).
Dalam utilitas Keychain Access, pada tab **Kontrol Akses** untuk `git-codecommit.us-east-2.amazonaws.com`, pilih **Izinkan semua aplikasi mengakses item ini (akses ke item ini tidak dibatasi)**. Hal ini mencegah pop-up, tetapi kredensialnya akhirnya berakhir (rata-rata, dalam waktu sekitar 15 menit) dan Anda melihat pesan kesalahan 403. Jika ini terjadi, Anda harus menghapus item keychain untuk memulihkan fungsionalitas.
Untuk informasi selengkapnya, lihat [Git untuk macOS: Saya mengkonfigurasi pembantu kredensial dengan sukses, tapi sekarang saya menolak akses ke repositori saya (403)](troubleshooting-ch.md#troubleshooting-macoshttps).
## Langkah 4: Hubungkan ke CodeCommit konsol dan kloning repositori
Jika administrator telah mengirimi Anda nama dan detail koneksi untuk CodeCommit repositori, Anda dapat melewati langkah ini dan mengkloning repositori secara langsung.
**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. Buka terminal dan jalankan perintah **git clone** dengan HTTPS URL yang Anda salin. Misalnya, untuk mengkloning repositori yang dinamai *MyDemoRepo* repo lokal yang dinamai *my-demo-repo* di Wilayah Timur AS (Ohio):
```
git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
```
## Langkah selanjutnya
Anda telah menyelesaikan prasyaratnya. Ikuti langkah-langkah [Memulai dengan CodeCommit ](getting-started-cc.md) untuk mulai menggunakan CodeCommit.