Menggunakan Library Klien Cloud di Cloud Code

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. 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. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

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

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.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

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

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):

Perhatian: Menghapus project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
• Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.

Jika Anda berencana mempelajari berbagai arsitektur, tutorial, atau panduan memulai, menggunakan kembali project dapat membantu agar Anda tidak melampaui batas kuota project.

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

• Pelajari Cloud Translation API lebih lanjut
• Pelajari Library Klien Cloud lebih lanjut
• Pelajari lebih lanjut Cloud Code untuk VS Code