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 melakukan operasi Git standar seperti git clone, git pull, dan git push. Autentikasi lokal tidak diperlukan untuk melakukan operasi di konsol Google Cloud, misalnya, untuk menjelajahi 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, Anda harus membuat pasangan kunci terlebih dahulu di sistem lokal tempat Anda ingin mengakses repositori. Kemudian, Anda mendaftarkan kunci publik ke Google Cloud. Jika sudah memiliki pasangan kunci SSH di sistem, Anda dapat menggunakan kembali kunci tersebut untuk autentikasi. Anda dapat mendaftarkan maksimal 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 terinstal di sistem lokal Anda.

  2. Di 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 berikut ini:
      • rsa
      • ecdsa
      • ed25519

    Contoh:

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

    2. Saat diminta, biarkan frasa sandi kosong dan tekan Enter.

  3. Mendaftarkan kunci Anda

Windows

  1. Pastikan PuTTY diinstal di sistem lokal Anda.

  2. Dari menu Start Windows, mulai PuTTYGen.

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

  4. Klik Generate.

    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.

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

Di 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 Windows, mulai PuTTYGen.

  2. Di jendela yang terbuka, klik Muat.

  3. Jelajahi sistem file lokal untuk menemukan file kunci publik Anda, lalu pilih file tersebut.

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

Mendaftarkan kunci publik

  1. Di konsol Google Cloud, buka halaman Manage SSH Keys.

    Buka Cloud Source Repositories

  2. Klik Register SSH key.

    Dialog Register SSH Key akan terbuka.

  3. Di kolom Key name, ketik nama unik untuk kunci.

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

  5. Klik Daftar.

Setelah menyiapkan autentikasi SSH, Anda dapat meng-clone repositori apa pun yang memiliki peran dan izin yang diperlukan, atau mendorong konten repositori lokal ke repositori yang dihosting kosong.

Melakukan autentikasi menggunakan gcloud CLI

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

  1. Pastikan gcloud CLI terinstal di sistem lokal Anda.

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

Melakukan autentikasi menggunakan kredensial yang dibuat secara manual

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

  1. Buka halaman Konfigurasi Git untuk membuat kredensial Anda.

    Buka halaman Konfigurasi 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.