Menyiapkan project dan lingkungan pengembangan

Panduan ini menjelaskan cara menyiapkan project Google Cloud untuk mulai menggunakan Vertex AI Vision.

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

  3. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

    gcloud init

  5. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

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

  7. Enable the Vertex AI Vision API: 

    gcloud services enable visionai.googleapis.com

  8. Set up authentication:

    1. Create the service account: 

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Replace SERVICE_ACCOUNT_NAME with a name for the service account.

    2. Grant the roles/visionai.editor IAM role to the service account: 

      gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/visionai.editor

      Replace the following:

      • SERVICE_ACCOUNT_NAME: the name of the service account
      • PROJECT_ID: the project ID where you created the service account

    3. Generate the key file: 

      gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

      Replace the following:

      • FILE_NAME: a name for the key file
      • SERVICE_ACCOUNT_NAME: the name of the service account
      • PROJECT_ID: the project ID where you created the service account

  9. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.

  10. Install the Google Cloud CLI.

  11. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

    gcloud init

  13. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

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

  15. Enable the Vertex AI Vision API: 

    gcloud services enable visionai.googleapis.com

  16. Set up authentication:

    1. Create the service account: 

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Replace SERVICE_ACCOUNT_NAME with a name for the service account.

    2. Grant the roles/visionai.editor IAM role to the service account: 

      gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com" --role=roles/visionai.editor

      Replace the following:

      • SERVICE_ACCOUNT_NAME: the name of the service account
      • PROJECT_ID: the project ID where you created the service account

    3. Generate the key file: 

      gcloud iam service-accounts keys create FILE_NAME.json --iam-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

      Replace the following:

      • FILE_NAME: a name for the key file
      • SERVICE_ACCOUNT_NAME: the name of the service account
      • PROJECT_ID: the project ID where you created the service account

  17. Set the environment variable GOOGLE_APPLICATION_CREDENTIALS to the path of the JSON file that contains your credentials. This variable applies only to your current shell session, so if you open a new session, set the variable again.


    18. Tugas tertentu mengharuskan Anda menggunakan produk Google Cloud tambahan selain Vertex AI Vision. Anda mungkin perlu melakukan tugas penyiapan tambahan untuk menggunakan produk Google Cloud lainnya.

    Vertex AI Vision SDK

    Software Development Kit (SDK) Vertex AI Vision berisi alat dan library untuk mengembangkan program dan alur kerja kustom dengan Vertex AI Vision.

    Alat ini merujuk pada sekumpulan file sumber biner yang membantu produktivitas Anda saat menggunakan atau mengembangkan solusi menggunakan Vertex AI Vision. Anda juga dapat menambahkan file sumber biner ini ke dalam pembuatan skrip untuk membantu mengelola deployment skala yang lebih besar. Antarmuka command line (CLI) vaictl adalah contoh dalam kategori ini.

    Library mengacu pada serangkaian API pemrograman yang dapat Anda gunakan untuk mengelola, mengontrol, dan melakukan I/O berbagai bentuk secara terprogram dengan Vertex AI Vision. C++ Programming API adalah contoh dalam kategori ini.

    Kode untuk alat dan library bersifat open source dan kami menyambut baik developer untuk membangunnya secara langsung. Untuk alat, kami juga menawarkan file biner yang telah dibuat sebelumnya di platform tertentu yang dapat Anda download untuk digunakan secara langsung. Kami juga menawarkan image Docker untuk kasus ketika platform Anda tidak didukung secara langsung.

    Prasyarat

    Pertimbangkan prasyarat ini sebelum Anda menggunakan Vertex AI Vision SDK.

    Platform yang didukung

    Saat ini kami hanya mendukung langsung mesin x86 yang menjalankan distribusi Linux berbasis Debian. Kami juga menawarkan image Docker dengan alat yang sudah dibuat dan diinstal jika Anda menggunakan platform lain.

    Persyaratan software tambahan

    Sebagian besar dependensi software pihak ketiga yang diperlukan Vertex AI Vision SDK dikelola secara otomatis saat Anda menginstal biner bawaan. Namun, untuk menggunakan aspek tertentu dari fitur dan alur kerja SDK, Anda harus menginstal dependensi tambahan. Bagian ini mencantumkan pengecualian ini serta cara mendownload dan menginstalnya.

    Python SDK

    Paket pip Python menginstal semua dependensinya secara otomatis. Namun, penginstalan Python dasar yang mendasarinya harus memenuhi kondisi berikut:

    • Python >= 3.8.

    Membangun dependensi dari sumber

    Sebagian besar pengguna dapat menggunakan biner SDK bawaan untuk alur kerja mereka. Jika Anda ingin mengembangkan dan membangun SDK dari sumber, Anda juga harus memastikan sistem Anda memenuhi persyaratan berikut.

    • Instal Bazel. Untuk petunjuk penginstalan, lihat dokumentasi Bazel.

    • Di Ubuntu 20.04, Anda juga memerlukan beberapa dependensi sistem. Anda dapat menginstalnya dengan perintah berikut:

      apt-get install -y --no-install-recommends \
    autoconf \
    automake \
    build-essential \
    ca-certificates \
    flex \
    bison \
    python3 \
    nasm \
    libjpeg-dev

    Mendapatkan biner bawaan

    Alat vaictl adalah alat biner siap pakai yang dapat digunakan untuk mengontrol Vertex AI Vision, serta mengirim dan menerima data yang diprosesnya.

    Bagian ini menunjukkan cara mendownload dan menginstal alat ini.

    Instal paket Debian

    Anda memiliki dua opsi untuk menggunakan alat command line vaictl, yang Anda perlukan untuk bekerja dengan I/O (data streaming):

    • Instal alat command line secara lokal (OS: Debian GNU/Linux, arsitektur CPU: x86_64) atau
    • Jalankan perintah di image Docker yang telah menginstal semua dependensi.

    Gunakan langkah-langkah berikut untuk mendapatkan alat command line vaictl:

    Unduh paket

    Untuk penginstalan langsung, saat ini kami hanya mendukung distribusi Debian/Ubuntu.

    Anda juga dapat mendownload paket Debian ini dari halaman rilis GitHub Vertex AI Vision SDK.

    1. (Opsional) Hapus versi vaictl sebelumnya.

      Sebelum dapat menginstal alat command line vaictl, Anda harus menghapus semua versi alat sebelumnya di komputer Anda:

      sudo apt-get remove visionai
    2. Download paket yang diperlukan. Anda dapat mendownload paket dari halaman rilis GitHub, atau menggunakan perintah berikut: 
      wget https://github.com/google/visionai/releases/download/v0.0.5/visionai_0.0-5_amd64.deb
    3. Setelah mendownload paket, jalankan perintah berikut di direktori tempat Anda mendownload file: 
      sudo apt install ./visionai_0.0-5_amd64.deb
    4. Verifikasi penginstalan: 
      vaictl --help

    Mendapatkan Docker

    Anda bisa mendapatkan image Docker yang telah menginstal Vertex AI Vision SDK dan semua dependensinya. Image Docker ini tersedia di gcr.io/visionai-public-images/vaictl.

    1. Download image dari Container Registry: 
      docker pull gcr.io/visionai-public-images/vaictl
    2. Jalankan terminal container interaktif. 
      docker run -it --rm gcr.io/visionai-public-images/vaictl /bin/bash
    3. Memverifikasi fungsi: 
      vaictl --help

    Mendapatkan kode sumber

    Vertex AI Vision SDK bersifat open source dan tersedia secara publik di GitHub.

    Meskipun SDK bergantung pada definisi API layanan, ketergantungan ini sudah dikelola secara otomatis oleh Bazel dan Anda tidak perlu mendapatkannya secara eksplisit. Namun, jika Anda memerlukan akses langsung ke API layanan, Anda bisa mendapatkannya di repositori GitHub googleapis.

    SDK pemrograman Python

    Vertex AI Vision juga mendukung Python SDK. Untuk memprogram dengan SDK ini, pastikan Anda telah memenuhi dependensi Python SDK dasar sebelum menginstal Python SDK.

    Untuk mengetahui informasi referensi SDK, lihat Referensi Python SDK.

    Untuk contoh kode yang menggunakan Python SDK, lihat tutorial Face blur dengan Python SDK, atau lihat beberapa contoh dalam distribusi sumber di direktori visionai/python/examples/.

    Mendapatkan paket Python SDK

    Vertex AI Vision SDK juga berisi library Python. Download dan instal versi Python SDK yang telah dibuat sebelumnya dengan petunjuk berikut.

    1. Download paket.

      Anda dapat mendownload paket Python SDK dari halaman rilis GitHub Vertex AI Vision SDK, atau Anda dapat menjalankan perintah:

      wget https://github.com/google/visionai/releases/download/v0.0.5/visionai-0.0.5-py3-none-any.whl

    2. Opsional. Buat dan aktifkan lingkungan virtual baru:

      python3 -m venv vaivenv
source vaivenv/bin/activate

    3. Instal paket:

      pip3 install visionai-0.0.5-py3-none-any.whl

    4. Opsional. Konfirmasi bahwa penginstalan berhasil:

      python3

      import visionai

    5. Opsional. Nonaktifkan lingkungan virtual Anda:

      deactivate

    SDK pemrograman C++

    C++ adalah SDK pemrograman pertama yang kami dukung. SDK publik C++ terletak di visionai/public/streams.h. Untuk informasi referensi, lihat dokumentasi referensi.

    Langkah berikutnya

Sebelumnya
Panduan memulai: Membangun aplikasi di konsol