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.

  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 Cloud Life Sciences Service Agent akan dibuat.
  2. Akun layanan secara otomatis ditetapkan peran default lifesciences.workflowsRunner. Peran ini memungkinkan memulai dan menghentikan instance Compute Engine di dalam project Anda.

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

  • Upaya untuk menjalankan pipeline menggunakan API akan mengakibatkan error izin. Untuk memperbaiki masalah ini, lihat Pemecahan masalah.
  • API tidak dapat menonaktifkan 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 menyertakan alat command line gcloud, gsutil, dan bq.

  1. Download dan instal Google Cloud CLI.

  2. Lakukan inisialisasi Google Cloud CLI.

  3. Setelah Anda melakukan inisialisasi SDK, instal komponen Cloud Life Sciences:

    gcloud components update beta

    Jika menggunakan VM Compute Engine dengan penginstalan default gcloud CLI, 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 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 Konsol Google Cloud.

    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 Berikan akses project ke akun layanan ini, 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 Done.

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

  1. Buka halaman Akun Layanan di konsol Google Cloud.

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

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 selanjutnya