Menyiapkan project dan lingkungan pengembangan

Untuk membantu Anda mulai menggunakan Vertex AI, halaman ini akan memandu Anda cara membuat project Google Cloud 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. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

    5.

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

    8.

Menyiapkan autentikasi

    Select the tabs for how you plan to access the API:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

  1. Install the Google Cloud CLI.

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

    gcloud init

  3. Update and install gcloud components:

    gcloud components update
    gcloud components install beta

    4. 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. Install the Google Cloud CLI.

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

      gcloud init

    3. Update and install gcloud components:

      gcloud components update
      gcloud components install beta

    4. If you're using a local shell, then create local authentication credentials for your user account: 

      gcloud auth application-default login

      You don't need to do this if you're using Cloud Shell.

    Untuk informasi selengkapnya, lihat Menyiapkan autentikasi 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 menggunakan REST API di lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

    1. Install the Google Cloud CLI.

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

      gcloud init

    3. Update and install gcloud components:

      gcloud components update
      gcloud components install beta

    Untuk 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 informasi selengkapnya, lihat Akun layanan yang ditiru identitasnya.

    Untuk informasi tentang cara menyiapkan autentikasi bagi lingkungan produksi, lihat Set up Application Default Credentials for code running on Google Cloud di 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 membuat organisasi project jelas.
  2. Peran yang diperlukan:
    1. Akses ke sebagian besar kemampuan Vertex AI diberikan oleh peran IAM (roles/aiplatform.user) Vertex AI User dan seharusnya cukup untuk sebagian besar pengguna Vertex AI. Untuk kontrol penuh atas resource Vertex AI, Anda dapat meminta peran (roles/aiplatform.admin) Administrator Vertex AI. 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) pada project atau akun layanan default Compute Engine.
    3. Selain itu, untuk mengaktifkan API yang diperlukan, Anda memerlukan peran IAM (roles/serviceusage.serviceUsageAdmin) Admin Penggunaan Layanan atau administrator Anda harus mengaktifkan API untuk Anda dengan mengikuti beberapa langkah pertama.
  3. Minta administrator untuk mengaktifkan Vertex AI API untuk Anda. Jika Anda diberi peran IAM (roles/serviceusage.serviceUsageAdmin) Service Usage Admin, Anda dapat melakukannya sendiri.

Langkah berikutnya