Langkah-langkah penyiapan untuk koneksi HTTPS keAWS CodeCommitbersamagit-remote-codecommit

Jika Anda ingin terhubung keCodeCommitmenggunakan akun root, akses federasi, atau kredensi sementara, Anda harus mengatur akses menggunakangit-remote-codecommit. Utilitas ini menyediakan metode sederhana untuk mendorong dan menarik kode dariCodeCommitrepositori 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 federasi mengautentikasi, identitas dikaitkan dengan peran dan diberikan izin yang ditentukan oleh peran. Untuk informasi tentang peran federasi, lihatMembuat peran untuk Penyedia Identitas pihak ketigadiPanduan Pengguna IAM. Jika Anda menggunakan Pusat Identitas IAM, Anda mengonfigurasi set izin. Untuk mengontrol apa yang dapat diakses identitas Anda setelah diautentikasi, IAM Identity Center mengkorelasikan izin yang disetel ke peran dalam IAM. Untuk informasi tentang set izin, lihatSet izindiAWS IAM Identity CenterPanduan Pengguna.

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 IDE tidak support 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.

Prosedur ini ditulis dengan asumsi bahwa Anda memiliki akun Amazon Web Services, telah membuat setidaknya satu repositori diCodeCommit, dan gunakan pengguna IAM dengan kebijakan terkelola saat menyambung keCodeCommitrepositori. Untuk informasi tentang cara mengkonfigurasi akses untuk pengguna gabungan dan jenis kredensial berputar lainnya, lihat Menghubungkan ke repositori AWS CodeCommit dengan kredensial berputar.

Langkah 0: Instal prasyarat untukgit-remote-codecommit

Sebelum Anda dapat menggunakan git-remote-codecommit, Anda harus menginstal beberapa prasyarat di komputer lokal Anda. Ini termasuk:

• Python (versi 3 atau yang lebih baru) dan manajer paketnya, pip, jika belum terpasang. Untuk mengunduh dan menginstal versi terbaru dari Python, kunjungi situs Python.

• 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, komit, dan informasi lainnya diCodeCommitrepositori, Anda harus menginstal Git pada mesin lokal Anda. CodeCommitmendukung 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.

catatan

Git adalah platform yang berkembang dan diperbarui secara teratur. Terkadang, perubahan fitur dapat memengaruhi cara kerjanyaCodeCommit. Jika Anda mengalami masalah dengan versi tertentu dari Git danCodeCommit, tinjau informasi diPemecahan Masalah.

Langkah 1: Konfigurasi awal untukCodeCommit

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 mengaksesCodeCommit

1. Buat akun Amazon Web Services dengan membuka http://aws.amazon.com dan memilih Mendaftar.

2. 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.

   catatan

   CodeCommitmemerlukanAWS Key Management Service. Jika Anda menggunakan pengguna IAM yang sudah ada, pastikan tidak ada kebijakan yang dilampirkan pada pengguna yang secara tegas menolakAWS KMStindakan yang diperlukan olehCodeCommit. Untuk informasi selengkapnya, lihat AWS KMS dan enkripsi.

3. Masuk ke AWS Management Console dan buka konsol IAM di https://console.aws.amazon.com/iam/.

4. Di konsol IAM, di panel navigasi, pilihPengguna, dan kemudian pilih pengguna IAM yang ingin Anda konfigurasikanCodeCommitakses.

5. Pada tab Izin, pilih Tambahkan izin.

6. Dalam Berikan izin, pilih Lampirkan kebijakan yang ada secara langsung.

7. Dari daftar kebijakan, pilihAWSCodeCommitPowerUseratau kebijakan terkelola lainnya untukCodeCommitakses. Untuk informasi selengkapnya, lihat AWS kebijakan terkelola untuk CodeCommit.

   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 lebih lanjut tentangCodeCommitkebijakan terkelola dan berbagi akses ke repositori dengan grup dan pengguna lain, lihatBagikan sebuah repositoridanKontrol autentikasi dan akses untuk AWS CodeCommit.

Untuk menginstal dan mengonfigurasi AWS CLI

1. Pada komputer lokal Anda, unduh dan instal AWS CLI. Ini adalah prasyarat untuk berinteraksi denganCodeCommitdari 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 kredensial sementara dengan git-remote-codecommit.

   Untuk informasi selengkapnya, lihat Menyiapkan Antarmuka Baris Perintah AWS.

   catatan

   CodeCommitbekerja hanya denganAWS CLIversi 1.7.38 dan yang lebih baru. Sebagai praktik terbaik, instal atau tingkatkan AWS CLI untuk versi terbaru yang tersedia. Untuk menentukan versi AWS CLI yang telah Anda instal, jalankan perintah aws --version.

   Untuk meng-upgrade versi lama AWS CLI ke versi terbaru, lihat Menginstal AWS Command Line Interface.

2. Jalankan perintah ini untuk memverifikasi bahwaCodeCommitperintah untukAWS CLIdiinstal.

   aws codecommit help

   Perintah ini mengembalikan daftarCodeCommitperintah.

3. Konfigurasikan AWS CLI dengan profil dengan menggunakan perintah configure, sebagai berikut:.

   aws configure

   Saat diminta, tentukanAWSkunci akses danAWSkunci akses rahasia pengguna IAM untuk digunakanCodeCommit. Juga, pastikan untuk menentukan Wilayah AWS di 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 untuk digunakan dengan AWS CLI, lihat berikut ini:

   • Profil Bernama

   • Menggunakan Peran IAM dalamAWS CLI

   • Tetapkan perintah

   • Menghubungkan ke repositori AWS CodeCommit dengan kredensial berputar

   Untuk terkoneksi ke repositori atau sumber daya di Wilayah AWS lain, Anda harus mengkonfigurasi ulang AWS CLI dengan nama wilayah default. Nama Wilayah default yang didukung untukCodeCommittermasuk:

   • 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

   • pusat-1

   Untuk informasi selengkapnya tentang CodeCommit dan Wilayah AWS, lihat Wilayah dan titik akhir koneksi Git. Untuk informasi selengkapnya tentang IAM, access key, dan kunci rahasia, lihat Bagaimana Saya Mendapatkan Kredensials? dan Mengelola Access Key untuk Pengguna IAM. Untuk informasi selengkapnya tentang AWS CLI dan profil, lihat Profil Bernama.

Langkah 2: Instalgit-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

2. Pantau proses instalasi sampai Anda melihat pesan sukses.

Langkah 3: Hubungkan keCodeCommitkonsol dan kloning repositori

Jika administrator telah mengirimi Anda URL klon untuk digunakangit-remote-codecommituntukCodeCommitrepositori, Anda dapat melewati koneksi ke konsol dan mengkloning repositori secara langsung.

Untuk terhubung ke aCodeCommitrepositori

1. BukaCodeCommitkonsol dihttps://console.aws.amazon.com/codesuite/codecommit/home.

2. Dalam pemilih wilayah, pilih Wilayah AWS di mana repositori dibuat. Repositori adalah khusus untuk sebuah Wilayah AWS. Untuk informasi selengkapnya, lihat Wilayah dan titik akhir koneksi Git.

3. 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 pasangan kunci publik/swasta SSH dengan pengguna IAM Anda.

   catatan

   Jika Anda melihat halaman Selamat Datang bukan daftar repositori, tidak ada repositori yang terkait dengan akun AWS Anda di Wilayah AWS tempat Anda masuk. Untuk membuat repositori, lihat Buat AWS CodeCommit repositori atau ikuti langkah-langkah di tutorial Memulai dengan Git dan CodeCommit.

4. Di terminal atau command prompt, kloning repositori dengan perintah git clone. Gunakan HTTPSgit-remote-codecommitURL yang Anda salin dan namaAWS CLIprofil, 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 bernamaMyDemoRepoke repo lokal bernamamy-demo-repo:

   git clone codecommit://MyDemoRepo my-demo-repo

   Untuk mengkloning repositori yang sama menggunakan profil bernamaCodeCommitProfile:

   git clone codecommit://CodeCommitProfile@MyDemoRepo my-demo-repo

   Untuk mengkloning repositori dalam Wilayah AWS yang berbeda dari yang dikonfigurasi di profil Anda, termasuk nama Wilayah AWS. Misalnya:

   git clone codecommit::ap-northeast-1://MyDemoRepo my-demo-repo

Langkah selanjutnya

Anda telah menyelesaikan prasyaratnya. Ikuti langkah-langkahnya diMemulai dengan CodeCommit untuk mulai menggunakanCodeCommit.

Untuk mempelajari cara membuat dan mendorong commit pertama Anda, lihat Buat komit di AWS CodeCommit. Jika Anda baru mengenal Git, Anda mungkin juga ingin meninjau informasi di Di mana saya dapat mempelajari lebih lanjut tentang Git? dan Memulai dengan Git dan AWS CodeCommit.