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

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

      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. 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 melakukan inisialisasi gcloud CLI, update dan instal komponen yang diperlukan: 

        gcloud components update
gcloud components install beta

        5. 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. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

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

          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.

          If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

        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 menggunakan REST API di lingkungan pengembangan lokal, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.

        1. Install the 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 melakukan inisialisasi gcloud CLI, update 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 informasi selengkapnya, lihat Akun layanan yang ditiru identitasnya.

        Untuk mengetahui informasi tentang cara menyiapkan autentikasi bagi lingkungan produksi, lihat Set up Application Default Credentials for code running on 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 bermaksud menggunakan instance Vertex AI Workbench di Google Cloud, minta administrator Anda 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 Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin) atau administrator Anda harus 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