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
Pastikan OpenSSH terinstal di sistem lokal Anda.
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"
Jika diminta, masukkan nama file untuk file kunci publik. Untuk menerima lokasi
~/.ssh
default, tekan Enter, jika tidak, tentukan nama file.Saat diminta, biarkan frasa sandi kosong dan tekan Enter.
Windows
Pastikan PuTTY diinstal di sistem lokal Anda.
Dari menu Start Windows, mulai PuTTYGen.
Di jendela yang terbuka, pilih jenis kunci dari kolom Parameters.
Klik Generate.
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.
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
Dari menu Start Windows, mulai PuTTYGen.
Di jendela yang terbuka, klik Muat.
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
Di konsol Google Cloud, buka halaman Manage SSH Keys.
Klik Register SSH key.
Dialog Register SSH Key akan terbuka.
Di kolom Key name, ketik nama unik untuk kunci.
Di kolom Key, salin string kunci dari file kunci publik Anda.
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.
Pastikan gcloud CLI terinstal di sistem lokal Anda.
Di 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.
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.
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.