Membuat dan meng-clone repositori

Membuat dan meng-clone repositori

Buat repositori di Secure Source Manager dan clone ke komputer 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. Install the Google Cloud CLI.

3. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

4. To initialize the gcloud CLI, run the following command:

   gcloud init

5. Instal komponen alpha Google Cloud CLI:

   gcloud components install alpha

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 Secure Source Manager Repo Creator (roles/securesourcemanager.repoCreator) di project instance

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.

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 cara memberikan peran Secure Source Manager, lihat Kontrol akses dengan IAM dan Memberi pengguna akses instance.

Membuat repositori

Antarmuka web

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

   INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

   Ganti kode berikut:

   • INSTANCE_ID dengan nama instance.
   • PROJECT_NUMBER dengan nomor project Google Cloud instance. Untuk 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 + Buat repositori baru di kanan atas menu navigasi.

4. Isi detail repositori:

   1. ID repositori: Masukkan nama untuk repositori.

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

   2. Deskripsi: opsional. Deskripsi repositori.

      Perhatian: Jangan menempatkan data sensitif atau identitas dalam deskripsi atau kolom resource serupa lainnya. Kolom ini diperlakukan sebagai Data Layanan sesuai dengan Google Cloud Pemberitahuan Privasi.

   3. Initialize repository: Opsional. Pilih opsi ini jika Anda ingin menginisialisasi repositori dan menambahkan file .gitignore, lisensi, dan README.

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

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

   6. Cabang default: Nama cabang default.

5. Klik Kirim.

Repositori dibuat di instance Secure Source Manager Anda.

Peran Admin Repo (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 dan coba lagi.

Repositori yang telah Anda buat tercantum di antarmuka web Secure Source Manager di halaman Repositori saya.

Menyiapkan kredensial Anda

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

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 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 mengirimkan 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 akan tercantum di tab <> Code.

Pembersihan

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

Sebelum menghapus repositori, pastikan semua 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, 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 menyerupai 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.