Mencantumkan dan melihat repositori

Dokumen ini menguraikan cara menelusuri dan melihat repositori Secure Source Manager berdasarkan ID repositori lengkap atau sebagian.

Peran yang diperlukan

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

• Secure Source Manager Instance Accessor (roles/securesourcemanager.instanceAccessor) di instance Secure Source Manager
• Secure Source Manager Repo Reader (roles/securesourcemanager.repoReader) di repositori yang ingin Anda telusuri

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 dasar IAM mungkin juga berisi izin untuk menelusuri repositori. Anda tidak boleh memberikan 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 Memberikan akses instance kepada pengguna.

Membuat daftar repositori

antarmuka web

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.

Tab Repositori saya menampilkan semua repositori yang dapat Anda akses untuk dilihat.

API

Untuk mencantumkan detail semua repositori di region tertentu untuk instance Anda, gunakan metode HTTP dan URL berikut.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

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

Metode HTTP dan URL:

GET https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories?instance=projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_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 GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories?instance=projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_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 GET `
    -Headers $headers `
    -Uri "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories?instance=projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
    "repositories" : [
          {
            "createTime" : "2023-08-09T19:32:15Z",
            "instance" : "projects/012345678901/locations/us-central1/instances/my-instance",
            "name" : "projects/my-project/locations/us-central1/repositories/my-repo",
            "uris" : {
                "api" : "https://my-instance-012345678901-api.us-central1.sourcemanager.dev/v1/projects/my-project/locations/us-central1/repositories/my-repo",
                "gitHttps" : "https://my-instance-012345678901-git.us-central1.sourcemanager.dev/my-project/my-repo.git",
                "html" : "https://my-instance-012345678901.us-central1.sourcemanager.dev/my-project/my-repo"
            }
          }
    ]
}

Melihat detail untuk repositori tertentu

Untuk mencantumkan detail satu repositori, gunakan metode HTTP dan URL berikut.

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:

GET 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 GET \
     -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 GET `
    -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:

    {
      "createTime" : "2023-08-09T19:32:15Z",
      "instance" : "projects/012345678901/locations/us-central1/instances/my-instance",
      "name" : "projects/my-project/locations/us-central1/repositories/my-repo",
      "uris" : {
          "api" : "https://my-instance-012345678901-api.us-central1.sourcemanager.dev/v1/projects/my-project/locations/us-central1/repositories/my-repo",
          "gitHttps" : "https://my-instance-012345678901-git.us-central1.sourcemanager.dev/my-project/my-repo.git",
          "html" : "https://my-instance-012345678901.us-central1.sourcemanager.dev/my-project/my-repo"
      }
    }

Melihat repositori di antarmuka web

Anda dapat menelusuri repositori dalam tab Repositori saya berdasarkan kata kunci.

1. Di antarmuka web Secure Source Manager, masukkan kata kunci penelusuran Anda di kotak penelusuran Search repository names.

   Hasil penelusuran mencakup semua repositori yang menyertakan kata kunci Anda di ID repositorinya.

2. Pilih repositori yang ingin Anda lihat.

   Halaman repositori akan terbuka.

Langkah berikutnya

• Buat repositori.
• Memberikan peran tingkat repositori.
• Menghapus repositori.