Mulai

Halaman ini akan memandu Anda melalui langkah-langkah penyiapan yang diperlukan untuk menggunakan Cloud Life Sciences API.

(Jika telah menyelesaikan Mulai Cepat, Anda telah melakukan beberapa langkah ini. Tinjau halaman ini untuk memastikan Anda siap menggunakan Cloud Life Sciences API).

Sebelum memulai

  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 Cloud Life Sciences API.

    Enable the API

  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 Cloud Life Sciences API.

    Enable the API

    8.

    Memahami akun layanan dan peran default

    Saat Anda menjalankan pipeline untuk pertama kalinya (menggunakan gcloud CLI atau RPC dan REST API), langkah-langkah autentikasi berikut akan terjadi:

    1. Akun layanan yang disebut akun layanan Agen Layanan Cloud Life Sciences akan dibuat.
    2. Akun layanan secara otomatis diberi peran default lifesciences.workflowsRunner. Peran ini memungkinkan instance Compute Engine dimulai dan dihentikan di dalam project Anda.

    Jika Anda kemudian menghapus peran default dari akun layanan project yang relevan, Anda mungkin akan mengalami error berikut:

    • Upaya untuk menjalankan pipeline menggunakan API akan menghasilkan error izin. Untuk memperbaiki masalah ini, lihat Pemecahan masalah.
    • API tidak dapat mematikan instance yang sedang berjalan saat pipeline selesai, dan Anda akan terus ditagih untuk resource ini. Untuk memperbaiki masalah ini, lihat Pemecahan masalah.

    Menyiapkan Google Cloud CLI dan Google Cloud CLI

    Instal Google Cloud CLI untuk menggunakan alat dan library di Cloud Life Sciences, Compute Engine, Cloud Storage, dan BigQuery. SDK mencakup alat command line gcloud, gsutil, dan bq.

    1. Download dan instal Google Cloud CLI.

    2. Lakukan inisialisasi Google Cloud CLI.

    3. Setelah menginisialisasi SDK, instal komponen Cloud Life Sciences:

      gcloud components update beta

      Jika Anda menggunakan VM Compute Engine dengan penginstalan gcloud CLI default, Anda tidak dapat menginstal komponen menggunakan perintah sebelumnya. Untuk mengaktifkan Cloud Life Sciences API di VM Compute Engine, instal ulang gcloud CLI dengan menjalankan perintah berikut: 

      sudo apt-get remove google-cloud-sdk
    curl https://sdk.cloud.google.com | bash
    exec -l $SHELL
    gcloud init

    Mendownload kredensial untuk akses API

    Anda harus mendownload file kunci akun layanan untuk project jika Anda menggunakan salah satu metode berikut untuk mengakses Cloud Life Sciences API:

    • Contoh kode dari repositori GitHub Cloud Life Sciences
    • Alat selain Google Cloud CLI yang mengakses Cloud Life Sciences API secara langsung

    Selesaikan langkah-langkah berikut untuk membuat file kunci akun layanan:

    1. Buka halaman Credentials di Google Cloud console.

      Buka halaman Kredensial

    2. Klik Buat kredensial > Akun layanan.

    3. Di halaman Detail akun layanan, masukkan nama akun layanan, lalu klik Buat.

    4. Di tab Grant this service account access to project, pilih peran untuk akun layanan. Untuk akses terluas ke Cloud Life Sciences, pilih Cloud Life Sciences > Cloud Life Sciences Workflows Runner, lalu klik Lanjutkan.

    5. (Opsional) Isi tab Beri pengguna akses ke akun layanan ini.

    6. Klik Selesai.

    Untuk mendownload kunci akun layanan, selesaikan langkah-langkah berikut:

    1. Buka halaman Service Accounts di Google Cloud konsol.

      Buka halaman Akun Layanan

    2. Temukan baris akun layanan yang ingin Anda buatkan kunci. Di baris tersebut, klik , lalu klik Kelola kunci.

    3. Di halaman Keys, klik Add key, lalu klik Create new key.

    4. Pilih JSON untuk Jenis kunci, lalu klik Buat.

    Mengklik Buat akan mendownload file kunci akun layanan. Pastikan Anda menyimpan file ini dengan aman, karena file ini dapat digunakan untuk melakukan autentikasi sebagai akun layanan Anda. Anda dapat memindahkan dan mengganti nama file ini.

    Langkah berikutnya