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
Pastikan OpenSSH diinstal di sistem lokal Anda.
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"
Saat diminta, masukkan nama file untuk file kunci publik. Untuk menerima lokasi
~/.ssh
default, tekan Enter. Jika tidak, tentukan nama file.Jika diminta, kosongkan frasa sandi, lalu tekan Enter.
Windows
Pastikan PuTTY diinstal di sistem lokal Anda.
Dari menu Start di Windows, mulai PuTTYGen.
Di jendela yang terbuka, pilih jenis kunci dari kolom Parameters.
Klik Buat.
PuTTYGen menampilkan string kunci publik yang dihasilkan.
Tentukan frasa sandi untuk melindungi pasangan kunci.
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
Dari menu Start di Windows, mulai PuTTYGen.
Di jendela yang terbuka, klik Muat.
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
Di GCP Console, buka halaman Kelola Kunci SSH.
Klik Register SSH key.
Dialog Register SSH Key akan terbuka.
Di kolom Nama kunci, ketik nama unik untuk kunci tersebut.
Di kolom Key, salin string kunci dari file kunci publik Anda.
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.
Pastikan gcloud CLI diinstal di sistem lokal Anda.
Pada command prompt, jalankan
gcloud init
:gcloud init
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.
Buka halaman Konfigurasi Git untuk membuat kredensial Anda.
Buka jendela terminal.
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.