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
- 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.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Aktifkan API Google Kubernetes Engine and Cloud Translation.
-
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
-
Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.
-
Aktifkan API Google Kubernetes Engine and Cloud Translation.
- Instal Git agar Cloud Code dapat menjalankan operasi Git, seperti meng-clone sampel.
- Instal plugin Cloud Code jika Anda belum melakukannya.
Membuat aplikasi
- 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. - Simpan aplikasi baru. Sebuah notifikasi akan mengonfirmasi bahwa aplikasi Anda telah dibuat dan jendela baru dengan aplikasi Anda akan terbuka.
Menyiapkan kredensial
Untuk membuka terminal, klik Terminal > New Terminal.
Buat akun layanan untuk mengautentikasi permintaan API:
gcloud iam service-accounts create \ translation-quickstart \ --project PROJECT_ID
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'
Membuat kunci akun layanan:
gcloud iam service-accounts keys \ create key.json --iam-account \ translation-quickstart@PROJECT_ID.iam.gserviceaccount.com
Tetapkan kunci sebagai kredensial default Anda:
export \ GOOGLE_APPLICATION_CREDENTIALS=key.json
Memanggil Cloud Translation API dari aplikasi
Go
Instal Library Klien Cloud Cloud Translation API:
- Untuk membuka terminal, klik Terminal > New Terminal.
Jalankan perintah berikut:
go get cloud.google.com/go/translate/apiv3
Buat file
app.go
.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() { }
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
Di fungsi
main()
, panggiltranslateText()
. 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) }
Dari terminal, jalankan aplikasi Anda.
go run app.go
Node.js
Instal Library Klien Cloud Cloud Translation API:
- Klik Cloud Code, lalu luaskan explorer Cloud APIs.
- Luaskan Cloud AI lalu klik Cloud Translation API.
- Untuk menginstal library klien, klik NodeJS, lalu klik play_arrow
Run in terminal.
Buat file
app.js
di project Anda.Buka
app.js
dan impor library klien Terjemahan di awal file:const {TranslationServiceClient} = require('@google-cloud/translate');
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!';
Tambahkan fungsi
async
berikut, yang mendeteksi bahasa teksHello, 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}`); } }
Di akhir file
app.js
, panggiltranslateText()
:translateText();
Untuk menjalankan aplikasi Anda, buka palet perintah (tekan
Ctrl
/Cmd
+Shift
+P
), lalu jalankan Cloud Code: Run on Kubernetes.Setelah aplikasi di-deploy, lihat layanan yang sedang berjalan dengan membuka URL yang ditampilkan dalam webview.
Python
Instal Library Klien Cloud Cloud Translation API:
- Klik Cloud Code, lalu luaskan explorer Cloud APIs.
- Luaskan Cloud AI lalu klik Cloud Translation API.
- 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 menggunakanpip3
, bukanpip
. Jika Anda menggunakan Mac, revisi perintah untuk menggunakanpip3
dan tambahkan flag--user
.
Buat file
app.py
di project Anda.Di
app.py
, impor library klien di awal file:from google.cloud import translate
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"
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))
Di akhir
app.py
, panggiltranslate_text()
.translate_text()
Untuk menjalankan aplikasi Anda, buka palet perintah (tekan
Ctrl
/Cmd
+Shift
+P
), lalu jalankan Cloud Code: Run on Kubernetes.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:
- Di Kubernetes Explorer, jeda nama cluster Anda, lalu klik open_in_new Buka di Konsol Google Cloud.
- Klik Delete, lalu klik Delete.
Untuk menghapus project Anda (dan resource terkait, termasuk cluster apa pun):
- Di konsol Google Cloud, buka halaman Manage resource.
- Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
- 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