Membuat dan mengakses instance

Membuat dan mengakses instance

Buat instance Secure Source Manager dan akses antarmuka webnya untuk bersiap membuat repositori dan memberikan akses pengguna.

Catatan: Secure Source Manager tidak mendukung project yang memiliki cakupan domain. Jika ID project Anda berisi titik dua (:), Anda harus membuat project baru sebelum menggunakan Secure Source Manager.

Sebelum memulai

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

Instal Google Cloud CLI.

Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.

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

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Buat atau pilih Google Cloud project.

Peran yang diperlukan untuk memilih atau membuat project

• Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
• Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

• Buat Google Cloud project:

  gcloud projects create PROJECT_ID

  Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

• Pilih project Google Cloud yang Anda buat:

  gcloud config set project PROJECT_ID

  Ganti PROJECT_ID dengan nama project Google Cloud Anda.

Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

Aktifkan Secure Source Manager API:

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

gcloud services enable securesourcemanager.googleapis.com

Instal Google Cloud CLI.

Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi terbaru dengan menjalankan gcloud components update.

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

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Buat atau pilih Google Cloud project.

Peran yang diperlukan untuk memilih atau membuat project

• Pilih project: Memilih project tidak memerlukan peran IAM tertentu—Anda dapat memilih project mana pun yang telah diberi peran.
• Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

• Buat Google Cloud project:

  gcloud projects create PROJECT_ID

  Ganti PROJECT_ID dengan nama untuk Google Cloud project yang Anda buat.

• Pilih project Google Cloud yang Anda buat:

  gcloud config set project PROJECT_ID

  Ganti PROJECT_ID dengan nama project Google Cloud Anda.

Verifikasi bahwa penagihan diaktifkan untuk project Google Cloud Anda.

Aktifkan Secure Source Manager API:

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), yang berisi izin serviceusage.services.enable. Pelajari cara memberikan peran.

gcloud services enable securesourcemanager.googleapis.com

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna membuat instance Secure Source Manager, minta administrator untuk memberi Anda peran IAM Instance Owner (roles/securesourcemanager.instanceOwner) di project Google Cloud .

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

Peran Secure Source Manager tidak muncul di konsol Google Cloud hingga peran tersebut diberikan kepada principal. Untuk memberikan peran Secure Source Manager untuk pertama kalinya, lihat Memberikan dan mencabut peran IAM.

Membuat instance

1. Jalankan perintah berikut untuk membuat instance bernama my-instance di us-central1 lokasi. Anda mungkin diminta untuk melakukan autentikasi ke gcloud CLI.

   gcloud source-manager instances create my-instance \
       --region=us-central1
   

   Dengan:

   • my-instance adalah nama instance.
   • us-central1 adalah region tempat Anda membuat instance.

   Operasi pembuatan instance yang berjalan lama dimulai. Outputnya akan terlihat mirip dengan berikut ini:

   Create request issued for [my-instance].
   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata
     apiVersion: v1
     createTime: '2023-02-27T20:57:52.315609549Z'
     requestedCancellation: false
     target: projects/PROJECT_ID/locations/us-central1/instances/my-instance
     verb: create
   name: projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e
   

   Dengan:

   • projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e adalah OPERATION_NAME.
   • PROJECT_ID adalah project ID Anda.

   Diperlukan waktu hingga 60 menit untuk membuat instance.

2. Perhatikan OPERATION_NAME karena Anda harus menggunakannya untuk memeriksa status operasi.

3. Periksa status operasi create dengan menjalankan perintah berikut:

   gcloud source-manager operations describe OPERATION_NAME \
       --region=us-central1
   

   Ganti kode berikut:

   • OPERATION_NAME dengan nama operasi dari respons perintah create Anda.

   Setelah instance siap, responsnya akan terlihat mirip dengan berikut ini:

   {
   "name": "projects/PROJECT_ID/locations/us-central1/operations/operation-123456789012-5ec69948c0f2b-60dd727f-a9b97a2e",
   "metadata": {
     "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
     "createTime": "2022-11-01T14:31:32.420469714Z",
     "endTime": "2022-11-01T14:48:34.140378114Z",
     "target": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
     "verb": "create",
     "requestedCancellation": false,
     "apiVersion": "v1"
   },
   "done": true,
   "response": {
     "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.Instance",
     "name": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
     "createTime": "2022-11-01T14:31:32.416413630Z",
     "updateTime": "2022-11-01T14:31:32.416413630Z"
     },
     "state": "ACTIVE",
     "hostConfig": {
       "html": "my-instance-098765432109.us-central1.sourcemanager.dev",
       "api": "my-instance-098765432109-api.us-central1.sourcemanager.dev",
       "gitHttp": "my-instance-098765432109-git.us-central1.sourcemanager.dev"
     }
   }
   }
   

   Dengan:

   • my-instance-098765432109.us-central1.sourcemanager.dev adalah URL HTML instance.
   • PROJECT_ID adalah project ID Anda.
   Catatan: Pemeriksaan status dapat melaporkan penyelesaian sebelum instance beroperasi sepenuhnya. Jika Anda mengalami error saat mengakses instance setelah dibuat, tunggu 60 menit dan coba lagi sebelum menghubungi dukungan Secure Source Manager melalui [e-mail].

4. Salin URL HTML dari perintah status pemeriksaan yang berhasil dibuat. Anda akan memerlukan URL ini untuk mengakses instance melalui browser web.

Mengakses instance

Setelah instance dibuat, Anda dapat mengakses instance melalui antarmuka webnya menggunakan browser.

Catatan: Untuk membuat repositori di instance, Anda memerlukan peran Pembuat Repositori (roles/securesourcemanager.repoCreator) di project instance dan peran Pembuat Repositori Instance (roles/securesourcemanager.instanceRepositoryCreator) di instance Secure Source Manager.

1. Untuk mendapatkan URL HTML instance Anda, jalankan kembali perintah berikut:

      gcloud source-manager operations describe OPERATION_NAME \
       --region=us-central1
   

2. Salin URL HTML dari respons yang berhasil dari perintah gcloud source-manager operations describe ke kolom URL browser Anda.

3. Layar Oauth 2.0 akan muncul dan menanyakan apakah Anda ingin memberikan akses sourcemanager.dev ke akun Google Cloud Anda.

4. Klik tombol Allow.

5. Antarmuka web Secure Source Manager akan terbuka. Anda dapat membuat dan melihat repositori serta semua masalah dan permintaan pull terkait dari antarmuka web.

Pembersihan

Agar akun Google Cloud Anda tidak dikenai biaya untuk resource yang digunakan pada halaman ini, hapus project Google Cloud yang berisi resource tersebut.

Perhatian: Penghapusan project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika Anda menggunakan project yang ada untuk mengerjakan tugas di dokumen ini, saat Anda menghapusnya, pekerjaan lain dalam project tersebut juga akan dihapus.
• Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin juga membuat project ID kustom yang masih ingin digunakan pada masa mendatang. Agar tidak kehilangan URL yang menggunakan project ID tersebut, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari beberapa arsitektur, tutorial atau panduan memulai, dengan menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

1. Di Konsol Google Cloud , buka halaman Manage resources.

   Buka Kelola resource

2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Langkah berikutnya

• Membuat dan meng-clone repositori
• Memberikan akses instance kepada pengguna
• Menambahkan pengguna repositori