

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 SSH ke AWS CodeCommit repositori di Linux, macOS, atau Unix
<a name="setting-up-ssh-unixes"></a>

Sebelum Anda dapat terhubung CodeCommit untuk pertama kalinya, Anda harus menyelesaikan beberapa langkah konfigurasi awal. Setelah Anda mengatur komputer dan AWS profil Anda, Anda dapat terhubung ke repositori dan mengkloning CodeCommit repositori itu ke komputer Anda (juga dikenal sebagai membuat repo lokal). 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).

**Topics**
+ [Langkah 1: Konfigurasi awal untuk CodeCommit](#setting-up-ssh-unixes-account)
+ [Langkah 2: Instal Git](#setting-up-ssh-unixes-install-git)
+ [Langkah 3: Konfigurasikan kredensil di Linux, macOS, atau Unix](#setting-up-ssh-unixes-keys)
+ [Langkah 4: Connect ke CodeCommit konsol dan kloning repositori](#setting-up-ssh-unixes-connect-console)
+ [Langkah selanjutnya](#setting-up-ssh-unixes-next-step)

## Langkah 1: Konfigurasi awal untuk CodeCommit
<a name="setting-up-ssh-unixes-account"></a>

Ikuti langkah-langkah berikut untuk menyiapkan akun Amazon Web Services, membuat pengguna IAM, dan mengonfigurasi akses ke CodeCommit akun. 

**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)

**catatan**  
Jika Anda ingin menggunakan AWS CLI perintah dengan CodeCommit, instal file AWS CLI. Untuk informasi selengkapnya, lihat [Referensi baris perintah](cmd-ref.md).

## Langkah 2: Instal Git
<a name="setting-up-ssh-unixes-install-git"></a>

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: Konfigurasikan kredensil di Linux, macOS, atau Unix
<a name="setting-up-ssh-unixes-keys"></a>

### SSH dan Linux, macOS, atau Unix: Siapkan kunci publik dan pribadi untuk Git dan CodeCommit
<a name="setting-up-ssh-unixes-keys-unixes"></a>

**Untuk mengatur kunci publik dan pribadi untuk Git dan CodeCommit**

1. Dari terminal pada mesin lokal Anda, jalankan perintah **ssh-keygen**, dan ikuti petunjuk untuk menyimpan file ke direktori .ssh untuk profil Anda. 
**catatan**  
Pastikan untuk memeriksa dengan administrator sistem Anda tentang di mana file kunci harus disimpan dan pola penamaan file yang harus digunakan.

   Contoh:

   ```
   $ ssh-keygen
   
   Generating public/private rsa key pair.
   Enter file in which to save the key (/home/user-name/.ssh/id_rsa): Type /home/your-user-name/.ssh/ and a file name here, for example /home/your-user-name/.ssh/codecommit_rsa
   
   Enter passphrase (empty for no passphrase): <Type a passphrase, and then press Enter>
   Enter same passphrase again: <Type the passphrase again, and then press Enter>
   
   Your identification has been saved in /home/user-name/.ssh/codecommit_rsa.
   Your public key has been saved in /home/user-name/.ssh/codecommit_rsa.pub.
   The key fingerprint is:
   45:63:d5:99:0e:99:73:50:5e:d4:b3:2d:86:4a:2c:14 user-name@client-name
   The key's randomart image is:
   +--[ RSA 2048]----+
   |        E.+.o*.++|
   |        .o .=.=o.|
   |       . ..  *. +|
   |        ..o . +..|
   |        So . . . |
   |          .      |
   |                 |
   |                 |
   |                 |
   +-----------------+
   ```

   Ini menghasilkan: 
   + *codecommit\$1rsa*File, yang merupakan file kunci pribadi.
   + *codecommit\$1rsa.pub*File, yang merupakan file kunci publik.
**Tip**  
Secara default, **ssh-keygen** menghasilkan kunci 2048 bit. Anda dapat menggunakan parameter -t dan -b untuk menentukan jenis dan panjang kunci. Jika Anda ingin kunci 4096 bit dalam format rsa, Anda akan menentukan ini dengan menjalankan perintah dengan parameter berikut:   

   ```
   ssh-keygen -t rsa -b 4096
   ```
Untuk informasi selengkapnya tentang format dan panjang yang diperlukan untuk kunci SSH, lihat [Menggunakan IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_ssh-keys.html#ssh-keys-code-commit) dengan. CodeCommit

1. Jalankan perintah berikut untuk menampilkan nilai file kunci publik (*codecommit\$1rsa.pub*):

   ```
   cat ~/.ssh/codecommit_rsa.pub
   ```

   Salin nilai ini. Itu terlihat serupa dengan yang berikut ini:

   ```
   ssh-rsa EXAMPLE-AfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJB
   gNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb2
   5zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhc
   NMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAw
   DgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDAS=EXAMPLE user-name@ip-192-0-2-137
   ```

1. Masuk ke Konsol Manajemen AWS dan buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
**catatan**  
Anda dapat langsung melihat dan mengelola CodeCommit kredensialnya di **My Security** Credentials. Untuk informasi selengkapnya, lihat [Melihat dan mengelola kredensial Anda](setting-up.md#setting-up-view-credentials).

1. Di konsol IAM, pada panel navigasi, pilih **Pengguna**, dan dari daftar pengguna, pilih pengguna IAM Anda. 

1. Pada halaman detail pengguna, pilih tab **Kredensial Keamanan**, kemudian pilih **Unggah kunci publik SSH**.

1. Tempelkan isi kunci publik SSH Anda ke dalam bidang, dan kemudian pilih **Unggah kunci publik SSH**. 

1. Salin atau simpan informasi dalam **ID Kunci SSH** (misalnya,*APKAEIBAERJR2EXAMPLE*).   
![\[ID Kunci SSH di konsol IAM\]](http://docs.aws.amazon.com/id_id/codecommit/latest/userguide/images/codecommit-ssh-key-id-iam.png)
**catatan**  
Jika Anda memiliki lebih dari satu kunci SSH yang IDs diunggah, kunci terdaftar menurut abjad berdasarkan ID kunci, bukan berdasarkan tanggal unggah. Pastikan bahwa Anda telah menyalin ID kunci yang terkait dengan tanggal pengunggahan yang benar.

1. Di mesin lokal Anda, gunakan editor teks untuk membuat file konfigurasi di direktori \$1/.ssh, lalu tambahkan baris berikut ke file, di mana nilainya *User* adalah ID kunci SSH yang Anda salin sebelumnya:

   ```
   Host git-codecommit.*.amazonaws.com
     User APKAEIBAERJR2EXAMPLE
     IdentityFile ~/.ssh/codecommit_rsa
   ```
**catatan**  
Jika Anda memberi nama file kunci pribadi Anda selain*codecommit\$1rsa*, pastikan untuk menggunakannya di sini.  
Anda dapat mengatur akses SSH ke repositori di beberapa akun Amazon Web Services, Untuk informasi lebih lanjut, lihat [Memecahkan masalah koneksi SSH ke AWS CodeCommit](troubleshooting-ssh.md).

   Simpan dan beri nama file `config` ini.

1. Dari terminal, jalankan perintah berikut untuk mengubah izin file konfigurasi:

   ```
   chmod 600 config
   ```

1. Jalankan perintah berikut ini untuk menguji konfigurasi SSH Anda:

   ```
   ssh git-codecommit.us-east-2.amazonaws.com
   ```

   Anda diminta untuk mengonfirmasi koneksi karena `git-codecommit.us-east-2.amazonaws.com` belum termasuk dalam file host Anda yang dikenal. Sidik jari CodeCommit server ditampilkan sebagai bagian dari verifikasi (`a9:6d:03:ed:08:42:21:be:06:e1:e0:2a:d1:75:31:5e`untuk MD5 atau `3lBlW2g5xn/NA2Ck6dyeJIrQOWvn7n8UEs56fG6ZIzQ` untuk SHA256).
**catatan**  
CodeCommit sidik jari server unik untuk setiap orang Wilayah AWS. Untuk melihat sidik jari server untuk sebuah Wilayah AWS, lihat[Sidik jari server untuk CodeCommit](regions.md#regions-fingerprints).

   Setelah Anda mengkonfirmasi koneksi, Anda akan melihat konfirmasi bahwa Anda telah menambahkan server ke file host yang diketahui dan pesan koneksi yang berhasil. Jika Anda tidak melihat pesan sukses, periksa apakah Anda menyimpan `config` file di direktori \$1/.ssh dari pengguna IAM yang Anda konfigurasikan untuk diakses CodeCommit, dan apakah Anda menentukan file kunci pribadi yang benar. 

   Untuk informasi untuk membantu Anda memecahkan masalah, jalankan perintah `ssh` dengan parameter `-v`. Contoh:

   ```
   ssh -v git-codecommit.us-east-2.amazonaws.com
   ```

   Untuk informasi untuk membantu Anda memecahkan masalah koneksi, lihat [Memecahkan masalah koneksi SSH ke AWS CodeCommit](troubleshooting-ssh.md).

## Langkah 4: Connect ke CodeCommit konsol dan kloning repositori
<a name="setting-up-ssh-unixes-connect-console"></a>

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. Dari direktori /tmp, jalankan **git clone** dengan URL SSH yang Anda salin untuk mengkloning repositori. Misalnya, untuk mengkloning repositori yang dinamai *MyDemoRepo* repo lokal yang dinamai *my-demo-repo* di Wilayah Timur AS (Ohio):

   ```
   git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
   ```
**catatan**  
Jika Anda berhasil menguji koneksi Anda, tetapi perintah klon gagal, Anda mungkin tidak memiliki akses yang diperlukan ke file konfigurasi Anda, atau pengaturan lain mungkin bertentangan dengan file konfigurasi Anda. Coba hubungkan lagi, kali ini termasuk ID kunci SSH dalam perintah. Contoh:  

   ```
   git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo
   ```
Untuk informasi selengkapnya, lihat [Kesalahan akses: Kunci publik berhasil diunggah ke IAM namun koneksi gagal pada sistem Linux, macOS, atau Unix](troubleshooting-ssh.md#troubleshooting-ae4).

   Untuk informasi selengkapnya tentang cara menghubungkan ke repositori, lihat [Connect ke CodeCommit repositori dengan mengkloning repositori](how-to-connect.md#how-to-connect-http).

## Langkah selanjutnya
<a name="setting-up-ssh-unixes-next-step"></a>

Anda telah menyelesaikan prasyaratnya. Ikuti langkah-langkahnya [Memulai dengan CodeCommit ](getting-started-cc.md) untuk mulai menggunakan CodeCommit.