Menggunakan Library Klien Cloud di Cloud Code

Halaman ini menunjukkan cara memulai Library Klien Cloud dan Cloud Code dengan cepat. Anda akan menyiapkan aplikasi Kubernetes baru menggunakan aplikasi contoh Hello World, lalu mengupdate aplikasi untuk menggunakan Cloud Translation API untuk menerjemahkan respons ke bahasa Spanyol.

Sebelum memulai

  1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
  2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  4. Aktifkan API Google Kubernetes Engine and Cloud Translation.

    Mengaktifkan API

  5. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

    Buka pemilih project

  6. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

  7. Aktifkan API Google Kubernetes Engine and Cloud Translation.

    Mengaktifkan API

  8. Instal Git agar Cloud Code dapat menjalankan operasi Git, seperti meng-clone sampel.
  9. Instal plugin Cloud Code jika Anda belum melakukannya.

Membuat aplikasi

  1. Dari palet perintah (Cmd/Ctrl+Shift+P), jalankan Cloud Code: New Application, pilih Kubernetes Application, lalu pilih aplikasi Hello World dalam bahasa yang Anda inginkan. Misalnya, pilih Node.js: Hello World untuk membuat aplikasi Node.js Hello World awal.
  2. Simpan aplikasi baru. Sebuah notifikasi akan mengonfirmasi bahwa aplikasi Anda telah dibuat dan jendela baru dengan aplikasi Anda akan terbuka.

Menyiapkan kredensial

  1. Untuk membuka terminal, klik Terminal > New Terminal.

  2. Buat akun layanan untuk mengautentikasi permintaan API:

    gcloud iam service-accounts create \
    translation-quickstart \
    --project PROJECT_ID
    
  3. Berikan peran Cloud Translation API User ke akun layanan Anda:

    gcloud projects \
    add-iam-policy-binding \
    PROJECT_ID \
    --member='serviceAccount:translation-quickstart@PROJECT_ID.iam.gserviceaccount.com' \
    --role='roles/cloudtranslate.user'
    
  4. Membuat kunci akun layanan:

    gcloud iam service-accounts keys \
    create key.json --iam-account \
    translation-quickstart@PROJECT_ID.iam.gserviceaccount.com
    
  5. Tetapkan kunci sebagai kredensial default Anda:

    export \
     GOOGLE_APPLICATION_CREDENTIALS=key.json
    

Memanggil Cloud Translation API dari aplikasi

Go

  1. Instal Library Klien Cloud Cloud Translation API:

    1. Untuk membuka terminal, klik Terminal > New Terminal.
    2. Jalankan perintah berikut:

      go get cloud.google.com/go/translate/apiv3
      
  2. Buat file app.go.

  3. Buka app.go dan tambahkan nama paket, impor, serta kerangka aplikasi:

    package main
    
    import (
      "context"
      "fmt"
    
      translate "cloud.google.com/go/translate/apiv3"
      translatepb "google.golang.org/genproto/googleapis/cloud/translate/v3"
    )
    
    func translateText(w io.Writer, projectID string, sourceLang string, targetLang string, text string) error {
    
    }
    
    func main() {
    
    }
    
  4. Dalam fungsi translateText() Anda, tambahkan kode berikut, yang menerjemahkan teks yang ditentukan. Pilih File > Save untuk memformat ulang kode Anda:

    ctx := context.Background()
    client, err := translate.NewTranslationClient(ctx)
    if err != nil {
      return fmt.Errorf("NewTranslationClient: %v", err)
    }
    defer client.Close()
    
    req := &translatepb.TranslateTextRequest{
      Parent:             fmt.Sprintf("projects/%s/locations/global", projectID),
      SourceLanguageCode: sourceLang,
      TargetLanguageCode: targetLang,
      MimeType:           "text/plain", // Mime types: "text/plain", "text/html"
      Contents:           []string{text},
    }
    
    resp, err := client.TranslateText(ctx, req)
    if err != nil {
      return fmt.Errorf("TranslateText: %v", err)
    }
    
    // Display the translation for each input text provided
    for _, translation := range resp.GetTranslations() {
      fmt.Fprintf(w, "Translated text: %v\n", translation.GetTranslatedText())
    }
    
    return nil
    
  5. Di fungsi main(), panggil translateText(). Parameter value berikut diterjemahkan dari bahasa Inggris ke bahasa Spanyol:

    projectID := "<var>PROJECT_ID</var>"
    sourceLang := "en-US"
    targetLang := "es"
    text := "Text to translate"
    
    err := translateText(os.Stdout, projectID, sourceLang, targetLang, text)
    if err != nil {
      fmt.Print(err)
    }
    
  6. Dari terminal, jalankan aplikasi Anda.

    go run app.go
    

Node.js

  1. Instal Library Klien Cloud Cloud Translation API:

    1. Klik Cloud Code, lalu luaskan explorer Cloud APIs.
    2. Luaskan Cloud AI lalu klik Cloud Translation API.
    3. Untuk menginstal library klien, klik NodeJS, lalu klik play_arrow Run in terminal.
  2. Buat file app.js di project Anda.

  3. Bukaapp.js dan impor library klien Terjemahan di awal file:

    const {TranslationServiceClient} = require('@google-cloud/translate');
    
  4. Buat klien Translation API dan tambahkan variabel untuk project ID, lokasi, dan teks yang ingin diterjemahkan:

    // Instantiates a client
    const translationClient = new TranslationServiceClient();
    
    const projectId = 'PROJECT_ID';
    const location = 'global';
    const text = 'Hello, world!';
    
  5. Tambahkan fungsi async berikut, yang mendeteksi bahasa teks Hello, world! dan menerjemahkan teks ke bahasa Spanyol:

    async function translateText() {
        // Construct request
        const request = {
            parent: `projects/PROJECT_ID/locations/LOCATION`,
            contents: [text],
            mimeType: 'text/plain', // mime types: text/plain, text/html
            sourceLanguageCode: 'en',
            targetLanguageCode: 'es',
        };
    
        // Run request
        const [response] = await translationClient.translateText(request);
    
        for (const translation of response.translations) {
            console.log(`Translation: ${translation.translatedText}`);
        }
    }
    
  6. Di akhir file app.js, panggil translateText():

    translateText();
    
  7. Untuk menjalankan aplikasi Anda, buka palet perintah (tekan Ctrl/Cmd + Shift + P), lalu jalankan Cloud Code: Run on Kubernetes.

  8. Setelah aplikasi di-deploy, lihat layanan yang sedang berjalan dengan membuka URL yang ditampilkan dalam webview.

Python

  1. Instal Library Klien Cloud Cloud Translation API:

    1. Klik Cloud Code, lalu luaskan explorer Cloud APIs.
    2. Luaskan Cloud AI lalu klik Cloud Translation API.
    3. Untuk menginstal library klien, klik Python, lalu klik play_arrow Run in terminal.
      Catatan: Jika Anda menggunakan sistem operasi berbasis Linux, termasuk Chromebook, revisi perintah untuk menggunakan pip3, bukan pip. Jika Anda menggunakan Mac, revisi perintah untuk menggunakan pip3 dan tambahkan flag --user.
  2. Buat file app.py di project Anda.

  3. Di app.py, impor library klien di awal file:

    from google.cloud import translate
    
  4. Tambahkan fungsi translate_text. Tindakan ini akan menginisialisasi klien untuk berinteraksi dengan Cloud Translation API.

    def translate_text(text="Hello, world!", project_id="PROJECT_ID"):
    
    client = translate.TranslationServiceClient()
    location = "global"
    parent = "projects/PROJECT_ID/locations/LOCATION"
    
  5. Untuk menerjemahkan teks dari bahasa Inggris ke bahasa Spanyol dan mencetak hasilnya, dalam fungsi translate_text, tambahkan panggilan berikut ke Library Klien Cloud Cloud Translation API:

       response = client.translate_text(
        request={
            "parent": parent,
            "contents": [text],
            "mime_type": "text/plain",
            "source_language_code": "en-US",
            "target_language_code": "es",
        }
    )
    
    for translation in response.translations:
        print("Translated text: {}".format(translation.translated_text))
    
  6. Di akhir app.py, panggil translate_text().

    translate_text()
    
  7. Untuk menjalankan aplikasi Anda, buka palet perintah (tekan Ctrl/Cmd + Shift + P), lalu jalankan Cloud Code: Run on Kubernetes.

  8. Setelah aplikasi di-deploy, lihat layanan yang sedang berjalan dengan membuka URL yang ditampilkan dalam webview.

Pembersihan

Setelah Anda menghentikan aplikasi, semua resource Kubernetes yang di-deploy selama operasi akan dihapus secara otomatis.

Agar tidak menimbulkan biaya pada akun Anda untuk resource lain yang digunakan pada panduan memulai ini, pastikan untuk menghapus project atau menghapus cluster yang Anda buat jika ingin menggunakan kembali project tersebut.

Untuk menghapus cluster:

  1. Di Kubernetes Explorer, jeda nama cluster Anda, lalu klik open_in_new Buka di Konsol Google Cloud.
  2. Klik Delete, lalu klik Delete.

Untuk menghapus project Anda (dan resource terkait, termasuk cluster apa pun):

  1. Di konsol Google Cloud, buka halaman Manage resource.

    Buka Manage resource

  2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
  3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Dapatkan Dukungan

Untuk mengirim masukan, laporkan masalah di GitHub, atau ajukan pertanyaan di Stack Overflow.

Langkah selanjutnya