Memigrasi konten lokal atau tanpa versi ke AWS CodeCommit - AWS CodeCommit

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.

Memigrasi konten lokal atau tanpa versi ke AWS CodeCommit

Prosedur dalam topik ini menunjukkan cara memigrasikan proyek atau konten lokal yang ada di komputer Anda ke CodeCommit repositori. Sebagai bagian dari proses ini, Anda:

  • Selesaikan pengaturan awal yang diperlukan untuk CodeCommit.

  • Buat CodeCommit repositori.

  • Tempatkan folder lokal di bawah kontrol versi Git dan dorong isi folder itu ke CodeCommit repositori.

  • Lihat file di CodeCommit repositori.

  • Bagikan CodeCommit repositori dengan tim Anda.

Migrasi proyek lokal ke CodeCommit

Langkah 0: Pengaturan diperlukan untuk akses ke CodeCommit

Sebelum Anda dapat memigrasikan konten lokal ke CodeCommit, Anda harus membuat dan mengkonfigurasi pengguna IAM untuk CodeCommit dan mengkonfigurasi komputer lokal Anda untuk akses. Anda juga harus menginstal AWS CLI to manage CodeCommit. Meskipun Anda dapat melakukan sebagian besar CodeCommit tugas tanpa itu, AWS CLI menawarkan fleksibilitas saat bekerja dengan Git.

Jika Anda sudah siap CodeCommit, Anda dapat melompat ke depanLangkah 1: Buat CodeCommit repositori.

Untuk membuat dan mengkonfigurasi pengguna IAM untuk mengakses CodeCommit
  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

    CodeCommit membutuhkanAWS 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.

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

  4. Di konsol IAM, di panel navigasi, pilih Pengguna, lalu pilih pengguna IAM yang ingin Anda konfigurasi untuk akses. CodeCommit

  5. Pada tab Izin, pilih Tambahkan izin.

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

  7. 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 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 dan. Kontrol 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 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 kredensial sementara dengan git-remote-codecommit.

    Untuk informasi selengkapnya, lihat Menyiapkan Antarmuka Baris Perintah AWS.

    catatan

    CodeCommit hanya berfungsi dengan AWS CLI versi 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 bahwa CodeCommit perintah AWS CLI untuk diinstal.

    aws codecommit help

    Perintah ini mengembalikan daftar CodeCommit perintah.

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

    aws configure

    Saat diminta, tentukan kunci AWS akses dan kunci akses AWS rahasia pengguna IAM untuk digunakan. CodeCommit 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:

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

    • eu-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-sentral-1

    Untuk informasi lebih lanjut tentang CodeCommit danWilayah AWS, lihatWilayah 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.

Selanjutnya, Anda harus menginstal Git.

  • Untuk Linux, macOS, atau Unix:

    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.

    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.

  • Untuk Windows:

    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 Git untuk Windows. Jika Anda menggunakan link ini untuk menginstal Git, Anda dapat menerima semua pengaturan default instalasi kecuali untuk berikut:

    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.

CodeCommit mendukung otentikasi HTTPS dan SSH. Untuk menyelesaikan penyiapan, Anda harus mengonfigurasi kredensi Git untuk CodeCommit (HTTPS, direkomendasikan untuk sebagian besar pengguna), key pair SSH (SSH) untuk digunakan saat mengakses CodeCommit, git-remote-codecommit (direkomendasikan untuk pengguna yang menggunakan akses federasi), atau pembantu kredenal yang disertakan dalam. AWS CLI

Langkah 1: Buat CodeCommit repositori

Di bagian ini, Anda menggunakan CodeCommit konsol untuk membuat CodeCommit repositori yang Anda gunakan untuk sisa tutorial ini. Untuk menggunakan AWS CLI untuk membuat repositori, lihat Buatlah sebuah repositori (AWS CLI).

  1. Buka CodeCommit konsol di https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Di pemilih wilayah, pilih Wilayah AWS tempat Anda ingin membuat repositori tersebut. Untuk informasi selengkapnya, lihat Wilayah dan titik akhir koneksi Git.

  3. Pada halaman Repositori, pilih Buat repositori.

  4. Pada halaman Buat repositori, di Nama repositori, masukkan nama untuk repositori tersebut.

    catatan

    Nama repositori sensitif huruf besar dan kecil. Nama harus unik di Wilayah AWS untuk akun Amazon Web Services Anda.

  5. (Opsional) Di Deskripsi, masukkan deskripsi untuk repositori tersebut. Ini dapat membantu Anda dan pengguna lain mengidentifikasi tujuan repositori tersebut.

    catatan

    Bidang deskripsi menampilkan Markdown di konsol dan menerima semua karakter HTML dan karakter Unicode yang valid. Jika Anda adalah pengembang aplikasi yang menggunakan BatchGetRepositories API GetRepository atau dan Anda berencana untuk menampilkan bidang deskripsi repositori di browser web, lihat Referensi CodeCommit API.

  6. (Opsional) Pilih Tambahkan tag untuk menambahkan satu atau lebih tag repositori (label atribut khusus yang membantu Anda mengatur dan mengelola sumber daya AWS Anda) ke repositori Anda. Untuk informasi selengkapnya, lihat Menandai repositori di AWS CodeCommit.

  7. (Opsional) Perluas konfigurasi tambahan untuk menentukan apakah akan menggunakan default Kunci yang dikelola AWS atau kunci yang dikelola pelanggan Anda sendiri untuk mengenkripsi dan mendekripsi data dalam repositori ini. Jika Anda memilih untuk menggunakan kunci yang dikelola pelanggan Anda sendiri, Anda harus memastikan bahwa itu tersedia di Wilayah AWS tempat Anda membuat repositori, dan bahwa kuncinya aktif. Untuk informasi selengkapnya, lihat AWS Key Management Service dan enkripsi untuk repositori AWS CodeCommit.

  8. (Opsional) Pilih Aktifkan Amazon CodeGuru Reviewer untuk Java dan Python jika repositori ini berisi kode Java atau Python, dan Anda ingin Reviewer menganalisisnya. CodeGuru CodeGuru Reviewer menggunakan beberapa model pembelajaran mesin untuk menemukan cacat kode dan menyarankan perbaikan dan perbaikan dalam permintaan tarik. Untuk informasi selengkapnya, lihat Panduan Pengguna Amazon CodeGuru Reviewer.

  9. Pilih Buat.

Setelah dibuat, repositori muncul di daftar Repositori. Di kolom URL, pilih ikon salin, lalu pilih protokol (HTTPS atau SSH) yang akan digunakan untuk CodeCommit terhubung. Salin URL.

Misalnya, jika Anda menamai repositori Anda MyFirstRepodan Anda menggunakan HTTPS, URL akan terlihat seperti berikut:

https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyFirstRepo

Anda membutuhkan URL ini nanti di Langkah 2: Migrasikan konten lokal ke repositori CodeCommit .

Langkah 2: Migrasikan konten lokal ke repositori CodeCommit

Sekarang setelah Anda memiliki CodeCommit repositori, Anda dapat memilih direktori di komputer lokal Anda untuk dikonversi menjadi repositori Git lokal. Perintah git init dapat digunakan baik untuk mengkonversi konten yang ada, konten tanpa versi ke repositori Git atau, jika Anda belum memiliki file atau konten, untuk memulai repositori baru yang kosong.

  1. Dari terminal atau baris perintah pada komputer lokal Anda, ubah direktori ke direktori yang ingin Anda gunakan sebagai sumber untuk repositori Anda.

  2. Jalankan perintah berikut untuk mengkonfigurasi Git menggunakan cabang default bernama main:

    git config --local init.defaultBranch main

    Anda juga dapat menjalankan perintah ini untuk mengatur nama cabang default Anda ke main untuk semua repositori yang baru dibuat:

    git config --global init.defaultBranch main
  3. Jalankan perintah git init untuk memulai kontrol versi Git dalam direktori. Hal ini menciptakan subdirektori .git di akar direktori yang memungkinkan pelacakan kontrol versi. Folder .git juga berisi semua metadata yang diperlukan untuk repositori.

    git init
  4. Periksa status direktori yang dimulai dengan menjalankan perintah berikut:

    git status

    Tambahkan file yang ingin Anda tambahkan ke kontrol versi. Dalam tutorial ini, Anda menjalankan perintah git add dengan specifier . untuk menambahkan semua file dalam direktori ini. Untuk pilihan lain, konsultasikan dokumentasi Git Anda.

    git add .
  5. Buat commit untuk file yang ditambahkan dengan pesan commit.

    git commit -m "Initial commit"
  6. Jalankan git push perintah, tentukan URL dan nama CodeCommit repositori tujuan dan opsi. --all (Ini adalah URL yang Anda salin di Langkah 1: Buat CodeCommit repositori.)

    Misalnya, jika Anda menamai repositori Anda MyFirstRepodan Anda diatur untuk menggunakan HTTPS, Anda akan menjalankan perintah berikut:

    git push https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyFirstRepo --all

Langkah 3: Lihat file di CodeCommit

Setelah Anda mendorong isi direktori Anda, Anda dapat menggunakan CodeCommit konsol untuk dengan cepat melihat semua file di repositori.

  1. Buka CodeCommit konsol di https://console.aws.amazon.com/codesuite/codecommit/home.

  2. Di Repositori, pilih nama repositori (misalnya, MyFirstRepository) dari daftar.

  3. Lihat file dalam repositori untuk cabang, klon, URL, pengaturan, dan banyak lagi.

Langkah 4: Bagikan CodeCommit repositori

Saat Anda membuat repositori di CodeCommit, dua titik akhir dihasilkan: satu untuk koneksi HTTPS dan satu untuk koneksi SSH. Keduanya menyediakan koneksi yang aman melalui sebuah jaringan. Para pengguna Anda dapat menggunakan salah satu protokol. Kedua titik akhir tetap aktif terlepas dari protokol mana yang Anda rekomendasikan untuk para pengguna Anda. Sebelum Anda dapat membagikan repositori dengan orang lain, Anda harus membuat kebijakan IAM yang memungkinkan pengguna lain mengakses repositori Anda. Berikan petunjuk akses tersebut kepada pengguna Anda.

Buatlah kebijakan terkelola pelanggan untuk repositori Anda
  1. Masuk ke AWS Management Console dan buka konsol IAM di https://console.aws.amazon.com/iam/.

  2. Pada panel navigasi Dasbor, pilih Kebijakan, dan kemudian pilih Buat Kebijakan.

  3. Pada halaman Buat Kebijakan, pilih Impor kebijakan terkelola.

  4. Pada halaman Impor kebijakan terkelola, di Kebijakan filter, masukkan AWSCodeCommitPowerUser. Pilih tombol di samping nama kebijakan, lalu pilih Impor.

  5. Di halaman Buat kebijakan, pilih JSON. Ganti bagian “*” dari Resource baris untuk CodeCommit tindakan dengan Nama Sumber Daya Amazon (ARN) dari CodeCommit repositori, seperti yang ditunjukkan di sini:

    "Resource": [ "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo" ]
    Tip

    Untuk menemukan ARN untuk CodeCommit repositori, buka CodeCommit konsol, pilih nama repositori dari daftar, lalu pilih Pengaturan. Untuk informasi selengkapnya, lihat Tampilkan detail repositori.

    Jika Anda ingin kebijakan ini diterapkan ke lebih dari satu repositori, tambahkan setiap repositori sebagai sumber daya dengan menentukan ARN-nya. Sertakan koma antara setiap pernyataan sumber daya, seperti yang ditunjukkan di sini:

    "Resource": [ "arn:aws:codecommit:us-east-2:111111111111:MyDemoRepo", "arn:aws:codecommit:us-east-2:111111111111:MyOtherDemoRepo" ]

    Setelah Anda selesai mengedit, pilih Tinjau kebijakan.

  6. Pada halaman Kebijakan Tinjauan, di Nama, masukkan nama baru untuk kebijakan (misalnya, AWSCodeCommitPowerUser- MyDemoRepo). Secara opsional berikan deskripsi untuk kebijakan ini.

  7. Pilih Buat Kebijakan.

Untuk mengelola akses ke repositori Anda, buatlah sebuah grup IAM untuk para penggunanya, tambahkan pengguna IAM ke grup tersebut, lalu lampirkan kebijakan terkelola pelanggan yang Anda buat pada langkah sebelumnya. Melampirkan kebijakan lain yang diperlukan untuk akses, seperti IAMSelfManageServiceSpecificCredentials atau IAMUserSSHKeys.

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

  2. Dalam area navigasi Dasbor, pilih Grup, dan kemudian pilih Buat Grup Baru.

  3. Pada halaman Setel Nama Grup, di Nama Grup, masukkan nama untuk grup (misalnya, MyDemoRepoGroup), lalu pilih Langkah Berikutnya. Pertimbangkan memasukkan nama repositori sebagai bagian dari nama grup.

    catatan

    Nama ini harus unik di seluruh akun Amazon Web Services.

  4. Pilih kotak di sebelah kebijakan terkelola pelanggan yang Anda buat di bagian sebelumnya (misalnya, AWSCodeCommitPowerUser- MyDemoRepo).

  5. Pada halaman Tinjauan, pilih Buat Grup. IAM membuat grup ini dengan kebijakan tertentu yang sudah terlampir. Grup tersebut muncul dalam daftar grup yang terkait dengan akun Amazon Web Services Anda.

  6. Pilih nama grup Anda dari daftar.

  7. Di halaman ringkasan grup, pilih tab Pengguna, dan kemudian pilih Tambahkan Pengguna ke Grup. Pada daftar yang menampilkan semua pengguna yang terkait dengan akun Amazon Web Services Anda, pilih kotak di sebelah pengguna yang ingin Anda izinkan akses ke CodeCommit repositori, lalu pilih Tambah Pengguna.

    Tip

    Anda dapat menggunakan kotak Pencarian untuk menemukan pengguna dengan cepat berdasarkan nama.

  8. Bila Anda telah menambahkan pengguna Anda, tutup konsol IAM tersebut.

Setelah Anda membuat pengguna IAM yang akan digunakan untuk mengakses CodeCommit menggunakan grup kebijakan dan kebijakan yang Anda konfigurasikan, kirimkan informasi yang diperlukan kepada pengguna tersebut untuk terhubung ke repositori.

  1. Buka CodeCommit konsol di https://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. Pada halaman Repositori, pilih repositori yang Anda ingin bagikan.

  4. Dalam URL Klon, pilih protokol yang Anda inginkan agar digunakan oleh para pengguna Anda. Ini menyalin URL klon untuk protokol koneksi.

  5. Kirimkan URL klon kepada para pengguna Anda beserta petunjuk lainnya, seperti menginstal AWS CLI, mengkonfigurasi profil, atau menginstal Git. Pastikan untuk menyertakan informasi konfigurasi untuk protokol koneksi (misalnya, HTTPS).