AWS CodeCommit tidak lagi tersedia untuk pelanggan baru. Pelanggan yang sudah ada AWS CodeCommit dapat terus menggunakan layanan seperti biasa. Pelajari lebih lanjut”
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Langkah-langkah penyiapan untuk HTTPS koneksi 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 Membuat peran untuk penyedia identitas pihak ketiga (federasi) di Panduan IAM Pengguna. Jika Anda menggunakan Pusat IAM Identitas, Anda mengonfigurasi set izin. Untuk mengontrol apa yang dapat diakses identitas Anda setelah diautentikasi, Pusat IAM Identitas menghubungkan izin yang disetel ke peran. IAM Untuk informasi tentang set izin, lihat Set izin dalam Panduan Pengguna AWS IAM Identity Center .
Anda juga dapat menggunakan git-remote-codecommit dengan IAM pengguna. Tidak seperti metode HTTPS koneksi lainnya, git-remote-codecommit tidak memerlukan pengaturan kredensi Git untuk pengguna.
catatan
Beberapa IDEs tidak mendukung URL format klon yang digunakan olehgit-remote-codecommit. Anda mungkin harus mengkloning repositori secara manual ke komputer lokal Anda sebelum Anda dapat bekerja dengannya sesuai keinginan Anda. IDE 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 di CodeCommit, dan menggunakan IAM pengguna 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.
Topik
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
Untuk informasi selengkapnya tentang pengaturan dan penggunaan git-remote-codecommit, lihatLangkah-langkah penyiapan untuk HTTPS koneksi AWS CodeCommit dengan 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 lain 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
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 diPemecahan Masalah.
Langkah 1: Konfigurasi awal untuk CodeCommit
Ikuti langkah-langkah ini untuk membuat IAM pengguna, mengkonfigurasinya dengan kebijakan yang sesuai, mendapatkan kunci akses dan kunci rahasia, dan menginstal dan mengkonfigurasi AWS CLI.
Untuk membuat dan mengkonfigurasi IAM pengguna untuk mengakses CodeCommit
Buat akun Amazon Web Services dengan membuka http://aws.amazon.com
dan memilih Mendaftar. Buat IAM pengguna, atau gunakan yang sudah ada, di akun Amazon Web Services Anda. Pastikan Anda memiliki ID kunci akses dan kunci akses rahasia yang terkait dengan IAM pengguna tersebut. Untuk informasi selengkapnya, lihat Membuat IAM Pengguna di akun Amazon Web Services Anda.
catatan
CodeCommit membutuhkan AWS Key Management Service. Jika Anda menggunakan IAM pengguna 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.
Masuk ke AWS Management Console dan buka IAM konsol di https://console.aws.amazon.com/iam/
. -
Di IAM konsol, di panel navigasi, pilih Pengguna, lalu pilih pengguna yang IAM ingin Anda konfigurasikan untuk CodeCommit akses.
Pada tab Izin, pilih Tambahkan izin.
-
Dalam Berikan izin, pilih Lampirkan kebijakan yang ada secara langsung.
Dari daftar kebijakan, pilih AWSCodeCommitPowerUseratau kebijakan terkelola lainnya untuk CodeCommit akses. Untuk informasi selengkapnya, lihat AWS kebijakan terkelola untuk CodeCommit.
Setelah memilih kebijakan yang ingin dilampirkan, pilih Berikutnya: Tinjau untuk meninjau daftar kebijakan yang akan dilampirkan ke IAM pengguna. 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 dan. Kontrol autentikasi dan akses untuk AWS CodeCommit
Untuk menginstal dan mengkonfigurasi AWS CLI
-
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.
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.
-
Jalankan perintah ini untuk memverifikasi bahwa CodeCommit perintah AWS CLI untuk diinstal.
aws codecommit helpPerintah ini mengembalikan daftar CodeCommit perintah.
-
Konfigurasikan AWS CLI dengan profil dengan menggunakan configure perintah, sebagai berikut:.
aws configureSaat diminta, tentukan kunci AWS akses dan kunci akses AWS rahasia IAM pengguna yang akan digunakan. CodeCommit Juga, pastikan untuk menentukan di Wilayah AWS mana repositori ada, seperti.
us-east-2Saat diminta untuk format output default, tentukanjson. Misalnya, jika Anda mengonfigurasi profil untuk IAM pengguna:AWS Access Key ID [None]:Type your IAM user AWS access key ID here, and then press EnterAWS Secret Access Key [None]:Type your IAM user AWS secret access key here, and then press EnterDefault region name [None]:Type a supported region for CodeCommit here, and then press EnterDefault output format [None]:Typejsonhere, and then press EnterUntuk informasi selengkapnya tentang membuat dan mengonfigurasi profil yang akan digunakan AWS CLI, lihat berikut ini:
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, lihatWilayah dan titik akhir koneksi Git. Untuk informasi selengkapnya tentangIAM, kunci akses, dan kunci rahasia, lihat Bagaimana Cara Mendapatkan Kredensi? dan Mengelola Kunci Akses untuk IAM Pengguna. Untuk informasi selengkapnya tentang profil AWS CLI dan profil, lihat Profil Bernama.
-
Langkah 2: Instal git-remote-codecommit
Ikuti langkah-langkah berikut untuk menginstal git-remote-codecommit.
Untuk menginstal git-remote-codecommit
-
Pada terminal atau baris perintah, jalankan perintah berikut:
pip install git-remote-codecommitcatatan
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-codecommitDi komputer yang menjalankan Windows:
pip install --user git-remote-codecommit -
Pantau proses instalasi sampai Anda melihat pesan sukses.
Langkah 3: Connect ke CodeCommit konsol dan kloning repositori
Jika administrator telah mengirimi Anda klon URL untuk digunakan untuk CodeCommit repositori, Anda dapat melewati koneksi ke konsol dan mengkloning repositori secara langsung. git-remote-codecommit
Untuk terhubung ke CodeCommit repositori
Buka CodeCommit konsol di https://console.aws.amazon.com/codesuite/codecommit/home
. -
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.
-
Temukan repositori yang ingin Anda sambungkan dari daftar dan pilih. Pilih Clone URL, lalu pilih protokol yang ingin Anda gunakan saat mengkloning atau menghubungkan ke repositori. Ini menyalin klonURL.
Salin HTTPS URL jika Anda menggunakan kredensi Git dengan IAM pengguna Anda atau pembantu kredensi yang disertakan dengan. AWS CLI
Salin HTTPS (GRC) URL jika Anda menggunakan git-remote-codecommit perintah di komputer lokal Anda.
Salin SSH URL jika Anda menggunakan SSH public/private key pair dengan pengguna AndaIAM.
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 atau ikuti langkah-langkah di tutorial Memulai dengan Git dan CodeCommit.
-
Di terminal atau command prompt, kloning repositori dengan perintah git clone. Gunakan yang HTTPS git-remote-codecommit URL 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
MyDemoRepoke repo lokal bernamamy-demo-repo:git clone codecommit://MyDemoRepo my-demo-repoUntuk mengkloning repositori yang sama menggunakan profil bernama
CodeCommitProfile:git clone codecommit://CodeCommitProfile@MyDemoRepo my-demo-repoUntuk mengkloning repositori yang berbeda Wilayah AWS dari yang dikonfigurasi di profil Anda, sertakan namanya. Wilayah AWS Sebagai contoh:
git clone codecommit::ap-northeast-1://MyDemoRepo my-demo-repo
Langkah selanjutnya
Anda telah menyelesaikan prasyaratnya. Ikuti langkah-langkah Memulai dengan CodeCommit untuk mulai menggunakan CodeCommit.
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.
