Secure Source Manager mendukung semua perintah klien Git SCM dan memiliki pelacakan masalah serta permintaan pull bawaan. HTTPS dan autentikasi SSH didukung.
Peran yang diperlukan
Untuk mendapatkan izin yang diperlukan untuk menggunakan Git guna berinteraksi dengan repositori Secure Source Manager, minta administrator Anda untuk memberi Anda peran IAM berikut:
-
Secure Source Manager Instance Accessor (
roles/securesourcemanager.instanceAccessor
) di instance Secure Source Manager -
Untuk meng-clone repositori:
Secure Source Manager Repo Reader (
roles/securesourcemanager.repoReader
) di repositori -
Untuk mengirimkan ke repositori:
Secure Source Manager Repo Writer (
roles/securesourcemanager.repoWriter
) di repositori
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran kustom atau peran yang telah ditentukan lainnya.
Untuk mengetahui informasi tentang cara memberikan peran Secure Source Manager, lihat Kontrol akses dengan IAM dan Memberikan akses instance kepada pengguna.
Instal Git dan Google Cloud CLI
Instal Git.
Jika Anda diminta untuk Choose a credential helper oleh penginstal Git, pilih None (Do not use a credential helper).
gcloud CLI versi
395.0.0
atau yang lebih baru diperlukan untuk menggunakan Git dengan HTTPS. Untuk memeriksa versi gcloud CLI Anda, jalankan perintah berikut:gcloud --version
Untuk mengupdate gcloud CLI, jalankan perintah berikut.
gcloud components update
Setelah memperbarui, jalankan
gcloud init
untuk melakukan inisialisasi gcloud CLI.Lihat dokumentasi gcloud CLI tentang mengupdate komponen untuk mengetahui informasi selengkapnya.
Menyiapkan kredensial Anda
Jika Anda melakukan autentikasi ke Secure Source Manager menggunakan penyedia identitas pihak ketiga dan Workforce Identity Federation, Anda tidak perlu menyelesaikan bagian ini. Sebagai gantinya, Anda harus membuat konfigurasi login kumpulan identitas tenaga kerja.
Tambahkan helper autentikasi Secure Source Manager ke konfigurasi Git global Anda dengan menjalankan perintah berikut:
Linux
git config --global credential.'https://*.*.sourcemanager.dev'.helper gcloud.sh
Versi Git yang lebih lama mungkin tidak mendukung karakter pengganti. Untuk menambahkan helper autentikasi tanpa karakter pengganti, jalankan perintah berikut:
git config --global credential.'https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev'.helper gcloud.sh
Ganti kode berikut:
INSTANCE_ID
dengan nama instance Secure Source Manager Anda.PROJECT_NUMBER
dengan nomor project Anda. Untuk mendapatkan bantuan menemukan nomor project Anda, lihat Mengidentifikasi project.LOCATION
dengan region instance. Untuk mengetahui informasi selengkapnya tentang region, lihat Lokasi.
Windows
git config --global credential.https://*.*.sourcemanager.dev.helper gcloud.cmd
Versi Git yang lebih lama mungkin tidak mendukung karakter pengganti. Untuk menambahkan helper autentikasi tanpa karakter pengganti, jalankan perintah berikut:
git config --global credential.https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev.helper gcloud.cmd
Ganti kode berikut:
INSTANCE_ID
dengan nama instance Secure Source Manager Anda.PROJECT_NUMBER
dengan nomor project Anda. Untuk mendapatkan bantuan menemukan nomor project Anda, lihat Mengidentifikasi project.LOCATION
dengan region instance. Untuk mengetahui informasi selengkapnya tentang region, lihat Lokasi.
Helper autentikasi menggunakan gcloud CLI untuk mengambil kredensialGoogle Cloud Anda saat menggunakan perintah Git dengan Secure Source Manager.
Untuk melakukan autentikasi ulang setelah penyiapan kredensial awal, jalankan perintah gcloud CLI berikut:
gcloud auth login
Membuat konfigurasi login workforce identity pool
Anda tidak perlu menyelesaikan bagian ini kecuali jika Anda menggunakan Workforce Identity Federation untuk melakukan autentikasi ke Secure Source Manager dengan penyedia identitas pihak ketiga.
Untuk melakukan autentikasi dengan kredensial kumpulan identitas tenaga kerja ke instance Secure Source Manager menggunakan perintah gcloud CLI atau perintah Git, Anda harus membuat konfigurasi login dengan kumpulan identitas tenaga kerja Anda.
Untuk membuat konfigurasi login workforce identity pool, ikuti petunjuk di bagian Mendapatkan token berumur pendek untuk Workforce Identity Federation guna membuat login berbasis browser dengan gcloud CLI.
Setelah diautentikasi, Anda dapat menggunakan perintah Git untuk berinteraksi dengan instance Secure Source Manager. Anda harus melakukan autentikasi ulang saat durasi sesi untuk workforce identity pool Anda berakhir.
Meng-clone repositori
Clone repositori dengan menjalankan perintah berikut:
git clone REPOSITORY_URL
Dengan REPOSITORY_URL
adalah URL HTTPS atau SSH yang ditampilkan di bagian atas
halaman repositori yang ingin Anda clone.
Mengirim repositori yang ada ke Secure Source Manager
Anda harus membuat repositori Secure Source Manager untuk bertindak sebagai remote sebelum Anda dapat mengirim ke repositori tersebut.
Untuk mengirim repositori Git yang ada ke repositori Secure Source Manager yang kosong, Anda perlu menambahkan repositori Secure Source Manager sebagai repositori jarak jauh dan mengirim ke repositori tersebut.
Untuk menyetel repositori Secure Source Manager sebagai jarak jauh, jalankan perintah berikut:
git remote add origin REPOSITORY_URL
Dengan
REPOSITORY_URL
adalah URL HTTPS atau SSH yang ditampilkan di bagian atas halaman repositori.Untuk mengirim ke repositori, jalankan perintah berikut:
git push -u origin main
Untuk mengetahui informasi selengkapnya tentang pengelolaan kode sumber Git, baca dokumentasi Git.
Langkah berikutnya
- Pelajari lebih lanjut Pengelolaan kode sumber Git
- Mencantumkan dan melihat repositori.