Menyiapkan autentikasi lokal

Sebelum dapat mengakses atau berinteraksi dengan repositori yang dihosting dari sistem, Anda harus menyiapkan autentikasi lokal di lingkungan Anda.

Setelah menyiapkan autentikasi lokal, Anda dapat mengakses repositori yang dihosting yang memiliki peran dan izin yang sesuai. Anda juga dapat menjalankan operasi Git standar seperti git clone, git pull, dan git push. Autentikasi lokal tidak diperlukan untuk melakukan operasi di konsol Google Cloud, misalnya, untuk menelusuri konten repositori.

Cloud Source Repositories mendukung jenis autentikasi berikut:

Melakukan autentikasi menggunakan SSH

Cloud Source Repositories memungkinkan Anda menggunakan autentikasi kunci publik SSH untuk mengakses repositori yang dihosting. Dalam skenario ini, pertama-tama Anda akan membuat pasangan kunci di sistem lokal tempat Anda ingin mengakses repositori. Kemudian Anda mendaftarkan kunci publik tersebut ke Google Cloud. Jika sudah memiliki pasangan kunci SSH di sistem, Anda dapat menggunakan kembali kunci tersebut untuk otentikasi. Anda dapat mendaftarkan hingga 20 kunci publik per Akun Google.

Cloud Source Repositories mendukung tiga jenis kunci SSH:

  • RSA (hanya untuk kunci dengan lebih dari 2048 bit)
  • ECDSA
  • ED25519

Membuat pasangan kunci

Pasangan kunci SSH terdiri dari kunci pribadi yang berada di sistem lokal Anda dan kunci publik yang Anda daftarkan ke Google Cloud.

Linux atau macOS

  1. Pastikan OpenSSH diinstal di sistem lokal Anda.

  2. Pada command prompt, masukkan perintah berikut:

    ssh-keygen -t [KEY_TYPE] -C "[USER_EMAIL]"
    

    Dengan keterangan:

    • [USER_EMAIL] adalah alamat email Anda.
    • [KEY_TYPE] adalah salah satu dari yang berikut:
      • rsa
      • ecdsa
      • ed25519

    Contoh:

    ssh-keygen -t rsa -C "user@example.com"
    
    1. Saat diminta, masukkan nama file untuk file kunci publik. Untuk menerima lokasi ~/.ssh default, tekan Enter. Jika tidak, tentukan nama file.

    2. Jika diminta, kosongkan frasa sandi, lalu tekan Enter.

  3. Mendaftarkan kunci Anda

Windows

  1. Pastikan PuTTY diinstal di sistem lokal Anda.

  2. Dari menu Start di Windows, mulai PuTTYGen.

  3. Di jendela yang terbuka, pilih jenis kunci dari kolom Parameters.

  4. Klik Buat.

    PuTTYGen menampilkan string kunci publik yang dihasilkan.

  5. Tentukan frasa sandi untuk melindungi pasangan kunci.

  6. Untuk menyimpan pasangan kunci yang Anda buat ke sistem lokal, klik Save Public Key dan Save Private Key.

Gunakan kunci yang ada

Anda juga dapat menggunakan pasangan kunci yang ada untuk autentikasi SSH.

Linux atau macOS

Secara default, file kunci publik terletak di direktori ~/.ssh Anda.

Pada command prompt, masukkan perintah berikut:

ls -a ~/.ssh

Nama file defaultnya adalah:

  • id_rsa.pub
  • id_ecdsa.pub
  • id_ed25519.pub

Windows

  1. Dari menu Start di Windows, mulai PuTTYGen.

  2. Di jendela yang terbuka, klik Muat.

  3. Jelajahi sistem file lokal untuk file kunci publik Anda dan pilih file tersebut.

    PuTTYGen menampilkan string kunci publik. Jika Anda menentukan frasa sandi saat menyimpan file kunci, PuTTYGen akan meminta Anda untuk memasukkannya sebelum Anda dapat melihat kunci publik.

Mendaftarkan kunci publik

  1. Di GCP Console, buka halaman Kelola Kunci SSH.

    Open Cloud Source Repositories

  2. Klik Register SSH key.

    Dialog Register SSH Key akan terbuka.

  3. Di kolom Nama kunci, ketik nama unik untuk kunci tersebut.

  4. Di kolom Key, salin string kunci dari file kunci publik Anda.

  5. Klik Daftar.

Setelah menyiapkan autentikasi SSH, Anda dapat meng-clone repositori yang peran dan izinnya diperlukan, atau mengirim konten repositori lokal ke repositori kosong yang dihosting.

Melakukan autentikasi menggunakan gcloud CLI

Dengan Cloud Source Repositories, Anda dapat melakukan autentikasi menggunakan gcloud CLI. Dalam skenario ini, Anda menjalankan perintah gcloud init di sistem Anda untuk menyiapkan autentikasi lokal.

  1. Pastikan gcloud CLI diinstal di sistem lokal Anda.

  2. Pada command prompt, jalankan gcloud init:

    gcloud init
    
  3. Ikuti petunjuknya.

Setelah menyiapkan autentikasi menggunakan gcloud CLI, Anda dapat menggunakan perintah Git standar untuk berinteraksi dengan repositori yang dihosting di Cloud Source Repositories.

Mengautentikasi dengan menggunakan kredensial yang dibuat secara manual

Anda juga dapat menggunakan kredensial yang dibuat secara manual untuk autentikasi. Cloud Source Repositories menyediakan sekumpulan skrip yang dapat Anda gunakan untuk membuat kredensial yang Anda perlukan secara manual untuk mengakses repositori yang dihosting.

  1. Buka halaman Konfigurasi Git untuk membuat kredensial Anda.

    Buka halaman Configure Git

  2. Buka jendela terminal.

  3. Ketik perintah berikut:

    git clone https://source.developers.google.com/p/PROJECT_ID/r/REPOSITORY_NAME
    

    Dengan keterangan:

    • PROJECT_ID adalah nama project Anda
    • REPOSITORY_NAME adalah nama repositori Anda

Setelah menyiapkan autentikasi dengan kredensial yang dibuat secara manual, Anda dapat berinteraksi dengan repositori yang dihosting di Cloud Source Repositories menggunakan perintah Git standar.