Menyiapkan project dan lingkungan pengembangan

Untuk membantu Anda mulai menggunakan Vertex AI, halaman ini memandu Anda cara membuat Google Cloud project dan mengaktifkan Vertex AI API. Jika Anda tidak memiliki izin untuk melakukan tugas ini, minta administrator untuk menyiapkan project dan mengaktifkan Vertex AI untuk Anda. Halaman ini juga membahas cara menyiapkan Google Cloud CLI di lingkungan pengembangan lokal Anda.

Menyiapkan project

Ikuti langkah-langkah berikut untuk menyiapkan project:

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

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

Menyiapkan autentikasi

    Pilih tab untuk melihat cara Anda berencana mengakses API:

    Konsol

    Saat menggunakan konsol Google Cloud untuk mengakses layanan Google Cloud dan API, Anda tidak perlu menyiapkan autentikasi.

    gcloud

    1. Instal Google Cloud CLI.

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

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

      gcloud init

    4. Setelah menginisialisasi gcloud CLI, update gcloud CLI dan instal komponen yang diperlukan: 

      gcloud components update
gcloud components install beta

    Untuk menyiapkan gcloud CLI agar menggunakan peniruan akun layanan untuk mengautentikasi ke Google API, alih-alih kredensial pengguna Anda, jalankan perintah berikut: 

    gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

    Untuk informasi selengkapnya, lihat Peniruan akun layanan.

    Library klien

    Untuk menggunakan library klien di lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

    1. Instal Google Cloud CLI.

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

    3. Setelah menginisialisasi gcloud CLI, update gcloud CLI dan instal komponen yang diperlukan: 

      gcloud components update
gcloud components install beta

    4. Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda: 

      gcloud auth application-default login

      Anda tidak perlu melakukan langkah ini jika menggunakan Cloud Shell.

      Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, konfirmasi bahwa Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

    Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Google Cloud .

    Untuk menyiapkan file ADC lokal agar menggunakan peniruan akun layanan untuk mengautentikasi ke Google API, alih-alih kredensial pengguna Anda, jalankan perintah berikut: 

    gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

    Untuk informasi selengkapnya, lihat Peniruan akun layanan.

    REST

    Untuk memakai REST API di lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

    1. Instal Google Cloud CLI.

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

    3. Setelah menginisialisasi gcloud CLI, update gcloud CLI dan instal komponen yang diperlukan: 

      gcloud components update
gcloud components install beta

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

    Anda dapat menggunakan peniruan akun layanan guna membuat token akses untuk permintaan REST API. Untuk mengetahui informasi selengkapnya, lihat Akun layanan yang identitasnya ditiru.

    Untuk mengetahui informasi tentang cara menyiapkan autentikasi bagi lingkungan produksi, lihat Menyiapkan Kredensial Default Aplikasi untuk kode yang berjalan di Google Cloud dalam dokumentasi autentikasi Google Cloud .

Meminta administrator untuk menyiapkan project Vertex AI untuk Anda

Bagian ini menjelaskan cara administrator memberikan peran yang diperlukan untuk menggunakan Vertex AI.

  1. Tentukan nama project dan project ID yang bermakna untuk mengidentifikasi project Anda. Jika Anda adalah bagian dari organisasi atau berencana membuat beberapa project, pertimbangkan konvensi penamaan dan hierarki folder yang diikuti, atau dapat diikuti, untuk memperjelas organisasi project.
  2. Peran yang diperlukan:
    1. Akses ke sebagian besar kemampuan Vertex AI diberikan oleh peran IAM Vertex AI User (roles/aiplatform.user) dan sudah cukup untuk sebagian besar pengguna Vertex AI. Untuk kontrol penuh atas resource Vertex AI, Anda dapat meminta peran Administrator Vertex AI (roles/aiplatform.admin). Untuk mempelajari perbedaan antara peran ini dan peran Vertex AI lainnya, lihat Kontrol akses Vertex AI dengan IAM.
    2. Jika Anda juga ingin menggunakan instance Vertex AI Workbench di Google Cloud, minta administrator untuk memberi Anda peran IAM Notebooks Administrator (roles/notebooks.admin) untuk project, serta peran IAM Service Account User (roles/iam.serviceAccountUser) di project atau akun layanan default Compute Engine.
    3. Selain itu, untuk mengaktifkan API yang diperlukan, Anda memerlukan peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin) atau administrator Anda perlu mengaktifkan API untuk Anda dengan mengikuti beberapa langkah pertama.
  3. Minta administrator Anda untuk mengaktifkan Vertex AI API untuk Anda. Jika Anda diberi peran IAM Service Usage Admin (roles/serviceusage.serviceUsageAdmin), Anda dapat melakukannya sendiri.

Langkah berikutnya