Membuat dan meng-clone repositori

Membuat dan meng-clone repositori

Buat repositori di Secure Source Manager dan clone ke mesin lokal Anda.

Sebelum memulai

1. Buat atau minta akses ke instance Secure Source Manager. Untuk mengetahui informasi selengkapnya, lihat Membuat instance Secure Source Manager.

2. Instal Google Cloud CLI.

3. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

4. Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

   gcloud init

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat repositori, minta administrator untuk memberi Anda peran IAM berikut:

• Peran Pembuat Repositori Instance Secure Source Manager (roles/securesourcemanager.instanceRepositoryCreator) di instance Secure Source Manager
• Peran Pembuat Repositori Secure Source Manager (roles/securesourcemanager.repoCreator) di project instance

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Catatan: Peran Admin Secure Source Manager (roles/securesourcemanager.admin) atau peran dasar IAM Pemilik (roles/owner) di project Anda juga berisi izin untuk membuat dan meng-clone repositori. Anda tidak boleh memberikan peran administrator atau peran dasar dalam lingkungan produksi, tetapi Anda dapat memberikannya dalam lingkungan pengembangan atau pengujian.

Untuk mengetahui informasi tentang pemberian peran Secure Source Manager, lihat Kontrol akses dengan IAM dan Memberikan akses instance kepada pengguna.

Membuat repositori

Antarmuka web

1. Untuk mengakses instance Secure Source Manager melalui antarmuka webnya, salin URL berikut ke kolom URL browser Anda.

   INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

   Ganti kode berikut:

   • INSTANCE_ID dengan nama instance.
   • PROJECT_NUMBER dengan nomor project instance. Google CloudUntuk mengetahui informasi tentang cara mengidentifikasi project, lihat Mengidentifikasi project.
   • LOCATION dengan region instance.

2. Lakukan autentikasi menggunakan kredensial Secure Source Manager Anda jika diperlukan.

3. Klik ikon + Create new repository di kanan atas menu navigasi.

4. Isi detail repositori:

   1. ID Repositori: Masukkan nama untuk repositori.

      Catatan: ID repositori harus mengikuti konvensi penamaan resource. ID tersebut hanya boleh menyertakan huruf kecil, angka, atau tanda hubung, harus diawali dengan huruf, dan tidak dapat diubah setelah membuat repositori.

   2. Deskripsi: Opsional. Deskripsi repositori.

      Perhatian: Jangan masukkan data sensitif atau data yang dapat mengidentifikasi ke dalam deskripsi atau kolom resource serupa lainnya. Kolom ini diperlakukan sebagai Data Layanan sesuai dengan Google Cloud Pemberitahuan Privasi.

   3. Default branch: Nama cabang default.

   4. Initialize repository: Opsional. Pilih opsi ini jika Anda ingin melakukan inisialisasi repositori dan menambahkan file .gitignore, lisensi, dan README.

   5. .gitignore: Opsional. Pilih file yang tidak akan dilacak menggunakan template menu drop-down.

   6. license: Opsional. Pilih lisensi umum dari menu drop-down.

5. Klik Create repository.

Repositori dibuat di instance Secure Source Manager Anda.

Peran Admin Repositori (roles/securesourcemanager.repoAdmin) diberikan kepada Anda saat Anda membuat repositori baru. Izin IAM baru mungkin memerlukan waktu hingga 2 menit untuk diterapkan. Jadi, jika Anda mendapatkan error izin saat mencoba mengakses repositori setelah pembuatan, tunggu beberapa menit, lalu coba lagi.

Repositori yang Anda buat tercantum di antarmuka web Secure Source Manager di halaman My repositories.

Menyiapkan kredensial

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

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 Google Cloud kredensial 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

Meng-clone repositori

1. Di antarmuka web Secure Source Manager, buka halaman repositori Anda.

2. Salin URL HTTPS di bagian atas halaman repositori Anda.

3. Clone repositori Anda dengan menjalankan perintah berikut:

   git clone REPOSITORY_URL
   

   Dengan REPOSITORY_URL adalah URL HTTPS yang ditampilkan di bagian atas halaman repositori yang ingin Anda clone.

   Abaikan peringatan tentang meng-clone repositori kosong.

Mengirim ke repositori

1. Di jendela terminal, ubah direktori ke repositori yang telah di-clone.

   cd REPOSITORY_NAME
   

   Dengan REPOSITORY_NAME adalah nama repositori Anda.

2. Buat file README kosong:

   touch README.md
   

3. Tambahkan file README ke Git dan buat pesan commit:

   git add README.md
   git commit -m "initial commit"
   

4. Kirim perubahan Anda ke repositori jarak jauh:

   git push -u origin main
   

   Git mengirim file dari cabang utama ke repositori jarak jauh origin. Outputnya mirip dengan yang berikut ini:

   Enumerating objects: 3, done.
   Counting objects: 100% (3/3), done.
   Writing objects: 100% (3/3), 211 bytes | 211.00 KiB/s, done.
   Total 3 (delta 0), reused 0 (delta 0), pack-reused 0
   remote: . Processing 1 references
   remote: Processed 1 references in total
   To https://instance-id-123456789012-git.us-central1.sourcemanager.dev/my-project/my-repo.git
   * [new branch]      main -> main
   branch 'main' set up to track 'origin/main'.
   

Melihat file Anda di Secure Source Manager

Di antarmuka web Secure Source Manager, klik nama repositori Anda.

Halaman repositori Anda akan terbuka dan file README.md Anda tercantum di tab <> Code.

Pembersihan

Agar akunAnda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut. Google Cloud

Sebelum menghapus repositori, pastikan file yang ingin Anda simpan tersedia di lokasi lain.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: project ID project Google Cloud tempat Secure Source Manager berjalan.
• LOCATION: region tempat instance Anda berada. Untuk mengetahui informasi tentang lokasi yang didukung, lihat Lokasi.
• REPOSITORY_ID: ID repositori.

Metode HTTP dan URL:

DELETE https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}
```

Responsnya mirip dengan yang berikut ini:

{"name":"operations/cc3ea26c-9b57-11ed-be0a-2e3b5910efef","metadata":{"@type":"type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata","createTime":"2023-01-23T19:54:49.904779921Z","endTime":"2023-01-23T19:54:50.947030402Z","target":"projects/my-project/locations/us-central1/repositories/my-repo","verb":"delete","apiVersion":"v1"},"done":true,"response":{"@type":"type.googleapis.com/google.protobuf.Empty"}

Langkah berikutnya

• Mencantumkan dan melihat repositori di antarmuka web Secure Source Manager.
• Menangani permintaan pull dan masalah di Secure Source Manager.