Erweiterung „Cloud Code for VS Code“ installieren

Die Erweiterung "Cloud Code for VS Code" unterstützt VS Code in der Google Cloud-Entwicklung.

Hinweise

Prüfen Sie vor der Installation von Cloud Code, ob die folgenden Tools auf Ihrem System installiert und eingerichtet sind:

  1. Visual Studio Code auf Ihrem Computer installieren und einrichten

  2. Sprachunterstützung muss installiert und konfiguriert sein.

    Die Cloud Code-Erweiterung funktioniert am besten mit den folgenden Sprachen:

    • Node.js (integrierte Unterstützung; keine Aktion erforderlich)
    • Go
    • Python
    • Java
    • .NET

  3. Installieren Sie Git. Git ist zum Kopieren von Beispielen auf Ihren Computer erforderlich.

  4. Installieren Sie den Docker-Client und fügen Sie ihn der Umgebungsvariable PATH hinzu:

    • Wenn Sie ausschließlich mit Cloud Build oder Jib erstellen, können Sie die Installation von Docker überspringen.
    • Wenn Sie Windows Home verwenden, finden Sie im Einrichtungsleitfaden für Docker Desktop für Windows eine Anleitung zum Einrichten Ihres Docker-Clients.
    • Wenn Sie WSL verwenden, Docker jedoch nicht für Computer installieren können, verwenden Sie stattdessen Minikube für die lokale Entwicklung mit Cloud Code.

  5. Wenn Sie Google Cloud verwenden, erstellen Sie ein Google Cloud-Projekt und aktivieren Sie dann die Abrechnung.

    Mit Projekten können Sie die zugehörigen Ressourcen für eine einzelne Anwendung an einem Ort erfassen, APIs verwalten, Google Cloud-Dienste aktivieren, Mitbearbeiter hinzufügen und entfernen und Berechtigungen für Google Cloud-Ressourcen verwalten.

Cloud Code installieren

Installieren Sie die Google Cloud Code-Erweiterung aus dem Visual Studio Code Marketplace.

Alternativ können Sie die Ansicht Extensions in VS Code öffnen:

  1. Klicken Sie auf Erweiterungssymbol Erweiterungen oder drücken Sie Ctrl/Cmd+Shift+X.

  2. Suchen Sie nach Google Cloud Code.

    Cloud Code-Erweiterung im VSC-Marktplatz

  3. Klicken Sie auf Install (Installieren).

  4. Starten Sie VS Code neu, wenn Sie dazu aufgefordert werden.

    Nachdem die Erweiterung erfolgreich installiert wurde, wird das Cloud Code-Symbol der Aktivitätsleiste hinzugefügt und ist einsatzbereit. Sie können die Cloud Code-Installation weiter konfigurieren, indem Sie Ihre Einstellungen über die Taskleiste der obersten Ebene festlegen: Code > Preferences (Einstellungen) > Settings > Extensions (Erweiterungen) > Cloud Code (Cloud Code).

Benutzerdefinierte Versionen von Abhängigkeiten

Standardmäßig sind Auto-Abhängigkeiten in Cloud Code aktiviert und einige Befehlszeilenabhängigkeiten werden automatisch installiert. Wenn Sie automatische Abhängigkeiten deaktivieren, können Sie benutzerdefinierte Versionen der Abhängigkeiten verwenden, müssen die Abhängigkeiten jedoch selbst installieren, damit Cloud Code funktioniert.

So verwenden Sie benutzerdefinierte Versionen von Cloud Code-Abhängigkeiten:

  1. Klicken Sie auf Einstellungen Verwalten > Einstellungen und setzen Sie Automatische Abhängigkeiten (cloudcode.autoDependencies) auf off.

  2. Installieren Sie die folgenden Abhängigkeiten auf Ihrem PATH:

Optional: Cloud Code vsix mit dem VsixSignTool verifizieren

Führen Sie die folgenden Schritte aus, um Cloud Code vsix mit dem VsixSignTool zu prüfen:

  1. Verwenden Sie Folgendes:

    • Nuget-Paketmanager
    • Windows
    • Produktionsrelease von Cloud Code

  2. Installieren Sie das Microsoft VsixSignTool und notieren Sie sich den Installationspfad.

  3. Öffnen Sie VS Code und rufen Sie Symbol „Erweiterungen“ in VSC Erweiterungen > Cloud Code auf.

  4. Klicken Sie auf dem Tab Details unter Extension Resources auf Marketplace.

  5. Klicken Sie in Ihrem Browser auf der Marketplace-Seite unter Ressourcen auf Erweiterung herunterladen, um die gepackte Version von Cloud Code herunterzuladen. Dadurch wird die gepackte Version von Cloud Code mit der Dateiendung .vsix in Ihr Standard-Downloadverzeichnis heruntergeladen.

  6. Wenn Sie eine andere Version als die aktuelle überprüfen möchten, klicken Sie auf den Tab Versionsverlauf und wählen Sie eine andere Version zum Herunterladen aus.

  7. Wenn der Download abgeschlossen ist, öffnen Sie ein Terminalfenster und führen Sie den folgenden Befehl aus:

    PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX

  8. Prüfen Sie, ob die Ausgabe mit Folgendem übereinstimmt:

    VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

Anmeldedaten für Google Cloud authentifizieren

Zur Unterstützung der Anwendungsentwicklung mit Google Cloud APIs werden Ihre Standardanmeldedaten für Anwendungen aktualisiert, wenn Sie sich in der gcloud CLI anmelden.

In Google Cloud anmelden

Wenn Sie nicht in Google Cloud angemeldet sind, gehen Sie so vor:

  1. Klicken Sie in der Cloud Code-Statusleiste auf Cloud Code – Sign in (Cloud Code – Anmeldung).

  2. Wenn Sie in Ihrer IDE zum ersten Mal eine Verbindung zu Google Cloud herstellen, werden Sie aufgefordert, https://accounts.google.com zur vertrauenswürdigen Domain hinzuzufügen. Klicken Sie im angezeigten Dialogfeld auf Vertrauenswürdige Domains konfigurieren:

    Dialogfeld „Vertrauenswürdige Domain konfigurieren“

  3. Folge der Anleitung, um dich über deinen Webbrowser anzumelden.

  4. Wenn Sie aufgefordert werden, Cloud Code den Zugriff auf Ihr Google-Konto zu gestatten, klicken Sie auf Zulassen.

Bekanntes Problem: Edge-Browser leitet bei Authentifizierungs-Callback zu HTTPS weiter

Wenn Sie Ihre Anmeldedaten mit dem Microsoft Edge-Browser authentifizieren, werden Sie möglicherweise feststellen, dass der Edge-Browser die URL http://localhost:3000 an https://localhost:3000 weiterleitet. Dies führt zu der folgenden Fehlermeldung:

The connection for this site is not secure. localhost sent an invalid response. Try running Windows Network Diagnostics. ERR_SSL_PROTOCOL_ERROR.

Sie können dieses Problem beheben, indem Sie localhost von der Weiterleitung ausschließen:

  1. Geben Sie in die Adressleiste des Edge-Browsers edge://net-internals/#hsts ein.

  2. Gehen Sie zum Abschnitt Domain-Sicherheitsrichtlinien löschen.

  3. Geben Sie localhost ein und klicken Sie dann auf Löschen.

Von Google Cloud abmelden

  1. Klicken Sie auf Cloud Code und maximieren Sie Help and Feedback (Hilfe und Feedback).
  2. Klicken Sie auf Von Google Cloud abmelden und wählen Sie Abmelden aus, wenn Sie dazu aufgefordert werden.
  3. Alternativ können Sie sich über die Befehlspalette abmelden. Drücken Sie Ctrl/Cmd + Shift + P oder klicken Sie auf Ansicht > Befehlspalette und dann auf Von allen Konten im Google Cloud SDK abmelden.

Aktives Google Cloud-Projekt ändern

  1. Klicken Sie in der Cloud Code-Statusleiste auf den Namen des aktiven Projekts.

    Aktiver Projektname in Statusleiste

  2. Wählen Sie im angezeigten Schnellauswahl-Menü sync_alt Projekt wechseln aus.

  3. Wählen Sie ein Projekt aus oder geben Sie Suchbegriffe in die Suchleiste ein, um die Projekte zu filtern.

Anmeldedaten für die lokale Fehlerbehebung in Anwendungen authentifizieren

Zusätzlich zu den Authentifizierungsschritten im Abschnitt Bei Google Cloud anmelden müssen Sie Ihre Anmeldedaten authentifizieren, um Fehler an einer Anwendung lokal in Ihrer IDE zu beheben, die Google API-Aufrufe durchführt.

Wenn Sie Ihre Anmeldedaten zum Debuggen von Anwendungen nicht authentifizieren, wird in Ihrer IDE eine Fehlermeldung angezeigt, wenn Sie versuchen, eine lokale Anwendung auszuführen bzw. Fehler zu beheben, die versucht, eine Google API aufzurufen.

Führen Sie die folgenden Schritte aus, um Ihre Anmeldedaten für die lokale Fehlerbehebung von Anwendungen zu authentifizieren:

  1. Installieren Sie gcloud auf Ihrem Computer, falls noch nicht geschehen.

  2. Führen Sie dazu diesen Befehl aus:

    gcloud auth application-default login

  3. Wenn Sie mit der lokalen Fehlerbehebung fertig sind, können Sie sich mit dem folgenden Befehl abmelden:

    gcloud auth application-default revoke

Weitere Informationen zu Standardanmeldedaten für Anwendungen und Google APIs finden Sie unter Mit Clientbibliotheken bei Cloud-Diensten authentifizieren.

Nächste Schritte

Support anfragen

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