Cloud-Clientbibliotheken in Cloud Code verwenden

Cloud-Clientbibliotheken in Cloud Code verwenden

Auf dieser Seite werden die ersten Schritte mit Cloud-Clientbibliotheken und Cloud Code Sie richten eine neue Kubernetes-Anwendung mit einem Hello World-Beispielanwendung und aktualisieren Sie dann die Anwendung für die Verwendung der Cloud Translation API verwenden, um die Antwort ins Spanische zu übersetzen.

Hinweise

1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

4. Google Kubernetes Engine and Cloud Translation APIs aktivieren.

   Aktivieren Sie die APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

7. Google Kubernetes Engine and Cloud Translation APIs aktivieren.

   Aktivieren Sie die APIs

8. Installieren Sie Git, damit Cloud Code kann Git-Vorgänge ausführen, z. B. das Klonen eines Stichprobe.
9. Installieren Sie das Cloud Code-Plug-in. falls noch nicht geschehen.

Anwendung erstellen

1. Über die Befehlspalette (Cmd/Ctrl + Shift + P) Führen Sie Cloud Code: New Application aus, wählen Sie Kubernetes Application aus. und wählen Sie dann eine Hello World-App in Ihrer bevorzugten Sprache aus. Wählen Sie beispielsweise Node.js: Hello World zum Erstellen einer Node.js-Startanwendung "Hello World"
2. Speichern Sie die neue Anwendung. In einer Benachrichtigung wird bestätigt, dass Ihre Anwendung erstellt wurde, und es wird ein in einem neuen Fenster geöffnet.

Anmeldedaten einrichten

Hinweis: Dienstkontoschlüssel stellen ein Sicherheitsrisiko dar, wenn sie nicht ordnungsgemäß verwaltet werden. Sie sollten nach Möglichkeit eine sicherere Alternative zu Dienstkontoschlüsseln auswählen. Wenn Sie sich mit einem Dienstkontoschlüssel authentifizieren müssen, sind Sie für die Sicherheit des privaten Schlüssels und für andere Vorgänge verantwortlich, die unter Best Practices für die Verwaltung von Dienstkontoschlüsseln beschrieben werden. Wenn Sie keinen Dienstkontoschlüssel erstellen können, ist das Erstellen von Dienstkontoschlüsseln für Ihre Organisation möglicherweise deaktiviert. Weitere Informationen finden Sie unter Standardmäßig sichere Organisationsressourcen verwalten.

1. Klicken Sie zum Öffnen eines Terminals auf Terminal > Neues Terminal.

2. Erstellen Sie ein Dienstkonto zur Authentifizierung Ihrer API-Anfragen:

   gcloud iam service-accounts create \
   translation-quickstart \
   --project PROJECT_ID
   

3. Weisen Sie dem Dienstkonto die Rolle „Cloud Translation API-Nutzer“ zu:

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

4. Erstellen Sie einen Dienstkontoschlüssel:

   gcloud iam service-accounts keys \
   create key.json --iam-account \
   translation-quickstart@PROJECT_ID.iam.gserviceaccount.com
   

5. Legen Sie den Schlüssel als Standardanmeldedaten fest:

   export \
    GOOGLE_APPLICATION_CREDENTIALS=key.json
   

Cloud Translation API über Ihre Anwendung aufrufen

Go

1. Installieren Sie die Cloud-Clientbibliotheken für die Cloud Translation API:

   1. Klicken Sie zum Öffnen eines Terminals auf Terminal > Neues Terminal.

   2. Führen Sie dazu diesen Befehl aus:

      go get cloud.google.com/go/translate/apiv3
      

2. Erstellen Sie eine app.go-Datei.

3. Öffnen Sie app.go und fügen Sie den Paketnamen, die Importe und das App-Basisgerüst hinzu:

   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. Fügen Sie der Funktion translateText() den folgenden Code hinzu. übersetzt den angegebenen Text. Wählen Sie Datei > Speichern, um Ihre Code:

   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. Rufen Sie in der main()-Funktion translateText() auf. Die folgenden werden vom Englischen ins Spanische übersetzt:

   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. Führen Sie die Anwendung im Terminal aus.

   go run app.go
   

Java

1. Öffnen Sie pom.xml und fügen Sie dem dependencies das folgende Code-Snippet hinzu: Abschnitt:

   <dependencies>
     <dependency>
       <groupId>junit</groupId>
       <artifactId>junit</artifactId>
       <version>4.11</version>
       <scope>test</scope>
     </dependency>
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>google-cloud-translate</artifactId>
     </dependency>
   </dependencies>
   

2. Fügen Sie dann in der Datei pom.xml das folgende Code-Snippet in den Abschnitt dependencyManagement:

   <dependencyManagement>
     <dependencies>
       <dependency>
         <groupId>com.google.cloud</groupId>
         <artifactId>libraries-bom</artifactId>
         <version>26.39.0</version>
         <type>pom</type>
         <scope>import</scope>
       </dependency>
     </dependencies>
   </dependencyManagement>
   

   Achten Sie darauf, dass Sie die neueste Version der von Google Cloud unterstützten Bibliotheken. Eine Liste der Versionen finden Sie unter Von Google Cloud unterstützte Bibliotheken.

3. Wenn Sie gefragt werden, ob Sie den Java-Klassenpfad/die Java-Konfiguration synchronisieren möchten, klicken Sie auf Immer.

4. Erstellen Sie eine Datei mit dem Namen app.java.

5. Fügen Sie in app.java die folgenden Importe nach dem Paket ein: Definition:

   import com.google.cloud.translate.v3.LocationName;
   import com.google.cloud.translate.v3.TranslateTextRequest;
   import com.google.cloud.translate.v3.TranslateTextResponse;
   import com.google.cloud.translate.v3.Translation;
   import com.google.cloud.translate.v3.TranslationServiceClient;
   import java.io.IOException;
   

6. Fügen Sie der Klasse App die Methode translateText() hinzu. Diese Methode legt Variablen fest und übergibt sie an eine überlastete translateText()-Methode. Die folgenden Parameterwerte übersetzen die englische Sprache ins Spanische:

   public static void translateText() throws IOException {
     String projectId = "<walkthrough-project-id/>";
     String targetLanguage = "es";
     String text = "Hello world!";
     translateText(projectId, targetLanguage, text);
   }
   

7. Fügen Sie eine überlastete translateText()-Methode hinzu. Bei dieser Methode wird Text in die Zielsprache übersetzt.

   public static void translateText(String projectId, String targetLanguage, String text)
     throws IOException {
   
     try (TranslationServiceClient client = TranslationServiceClient.create()) {
       LocationName parent = LocationName.of(projectId, "global");
   
       TranslateTextRequest request =
         TranslateTextRequest.newBuilder()
         .setParent(parent.toString())
         .setMimeType("text/plain")
         .setTargetLanguageCode(targetLanguage)
         .addContents(text)
         .build();
   
       TranslateTextResponse response = client.translateText(request);
   
       // Display the translation for each input text provided
       for (Translation translation : response.getTranslationsList()) {
         System.out.printf("Translated text: %s\n", translation.getTranslatedText());
       }
     }
   }
   

8. Ersetzen Sie die print-Anweisung in main durch einen Aufruf von translateText():

   try {
     translateText();
   }
   catch (IOException e) {
     e.printStackTrace();
   }
   

Node.js

1. Installieren Sie die Cloud-Clientbibliotheken für die Cloud Translation API:

   1. Klicken Sie auf . Cloud Code und maximieren Sie dann Cloud APIs Explorer.
   2. Maximieren Sie Cloud AI und klicken Sie dann auf Cloud Translation API
   3. Klicken Sie zum Installieren der Clientbibliothek auf NodeJS und dann auf play_arrow Im Terminal ausführen
      

2. Erstellen Sie in Ihrem Projekt eine app.js-Datei.

3. app.js öffnen und importieren Sie die Translation-Clientbibliothek am Anfang der Datei:

   const {TranslationServiceClient} = require('@google-cloud/translate');
   

4. Erstellen Sie einen Translation API-Client und fügen Sie Variablen für Ihre Projekt-ID hinzu. Standort und den Text, den Sie übersetzen möchten:

   // Instantiates a client
   const translationClient = new TranslationServiceClient();
   
   const projectId = 'PROJECT_ID';
   const location = 'global';
   const text = 'Hello, world!';
   

5. Fügen Sie die folgende async-Funktion hinzu. Damit wird die Sprache Ihres Hello, world!-Text und übersetzt den Text ins Spanische:

   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. Rufen Sie am Ende der Datei app.js translateText() auf:

   translateText();
   

7. Öffnen Sie zum Ausführen der Anwendung die Befehlspalette (drücken Sie Ctrl/Cmd + Shift + P) und dann ausführen Cloud Code: In Kubernetes ausführen

8. Nachdem die Anwendung bereitgestellt wurde, können Sie den laufenden Dienst anzeigen, indem Sie die Die in der WebView angezeigte URL.

Python

1. Installieren Sie die Cloud-Clientbibliotheken für die Cloud Translation API:

   1. Klicken Sie auf . Cloud Code und maximieren Sie dann Cloud APIs Explorer.
   2. Maximieren Sie Cloud AI und klicken Sie dann auf Cloud Translation API
   3. Klicken Sie auf Python und dann auf play_arrow Im Terminal ausführen
      Hinweis: Wenn Sie ein Linux-basiertes Betriebssystem verwenden, Chromebook: Ändern Sie den Befehl so, dass pip3 anstelle von pip Wenn Sie einen Mac verwenden, überarbeiten Sie den Befehl für pip3 und fügen Sie das Flag --user hinzu.

2. Erstellen Sie in Ihrem Projekt eine app.py-Datei.

3. Importieren Sie in app.py die Clientbibliothek am Anfang der Datei:

   from google.cloud import translate
   

4. Fügen Sie die Funktion translate_text hinzu. Initialisiert einen Client für die Interaktion 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. Um Text vom Englischen ins Spanische zu übersetzen und das Ergebnis auszudrucken, translate_text-Funktion hinzufügen, fügen Sie der Cloud Translation API den folgenden Aufruf hinzu Cloud-Clientbibliotheken:

      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. Rufen Sie am Ende von app.py translate_text() auf.

   translate_text()
   

7. Öffnen Sie zum Ausführen der Anwendung die Befehlspalette (drücken Sie Ctrl/Cmd + Shift + P) und dann ausführen Cloud Code: In Kubernetes ausführen

8. Nachdem die Anwendung bereitgestellt wurde, können Sie den laufenden Dienst anzeigen, indem Sie die Die in der WebView angezeigte URL.

Bereinigen

Nachdem Sie Ihre Anwendung beendet haben, werden alle Kubernetes-Ressourcen, die während werden die Ausführungen automatisch gelöscht.

Damit Ihrem Konto keine weiteren Ressourcen in Rechnung gestellt werden, die in diesem Löschen Sie das Projekt oder den von Ihnen erstellten Cluster, Sie das Projekt wiederverwenden möchten.

So löschen Sie den Cluster:

1. Im Kubernetes Explorer, halten Sie bei Ihrem Clusternamen an und klicken Sie dann auf open_in_new In der Google Cloud Console öffnen.
2. Klicken Sie auf Löschen und dann noch einmal auf Löschen.

So löschen Sie Ihr Projekt und die zugehörigen Ressourcen, einschließlich der Cluster:

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

1. Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten.

   Zur Seite „Ressourcen verwalten“

2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.

Support erhalten

Wenn Sie Feedback geben möchten, melden Sie Probleme auf GitHub oder stellen Sie eine Frage zu Stack Overflow.

Nächste Schritte

• Weitere Informationen zur Cloud Translation API
• Cloud-Clientbibliotheken
• Weitere Informationen zu Cloud Code for VS Code