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. Installieren und richten Sie Visual Studio Code auf Ihrem Computer ein.

  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 Erweiterungen 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 Marketplace

  3. Klicken Sie auf Install (Installieren).

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

    Nach der erfolgreichen Installation der Erweiterung wird das Cloud Code-Symbol zur Aktivitätsleiste hinzugefügt und kann verwendet werden. Sie können die Cloud Code-Installation weiter konfigurieren, indem Sie in der Taskleiste der Anwendung die entsprechenden Einstellungen festlegen: Code > Einstellungen > Einstellungen > Erweiterungen > Cloud Code.

Benutzerdefinierte Versionen von Abhängigkeiten

In Cloud Code sind standardmäßig Automatische Abhängigkeiten aktiviert und einige Befehlszeilenabhängigkeiten werden automatisch für Sie installiert. Wenn Sie automatische Abhängigkeiten deaktivieren, können Sie benutzerdefinierte Versionen der Abhängigkeiten verwenden. Sie 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 dann Automatische Abhängigkeiten (cloudcode.autoDependencies) auf off.

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

Optional: Cloud Code vsix mit VsixSignTool prüfen

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

  1. Sie sollten Folgendes verwenden:

    • NuGet-Paketmanager
    • Windows
    • Einen 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 für Erweiterungen in VSC Erweiterungen > Cloud Code auf.

  4. Klicken Sie auf dem Tab Details unter Erweiterungsressourcen auf Marketplace.

  5. Klicken Sie auf der Marketplace-Seite in Ihrem Browser 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 lieber eine andere Version als die aktuelle prü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 folgenden Befehl aus:

    PATH_TO_VSIXSIGNTOOL verify PATH_TO_DOWNLOADED_VSIX

  8. Prüfen Sie, ob die Ausgabe so aussieht:

    VsixSignTool Success: Package PATH_TO_DOWNLOADED_VSIX is valid.

Anmeldedaten für Google Cloud authentifizieren

Wenn Sie sich bei der gcloud CLI bei der Anwendungsentwicklung mit Google Cloud APIs anmelden, werden Ihre Standardanmeldedaten für Anwendungen aktualisiert.

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 – Anmelden.

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

    Dialogfeld „Vertrauenswürdige Domain konfigurieren“

  3. Folgen Sie der Anleitung, um sich über einen Webbrowser anzumelden.

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

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

Wenn Sie den Microsoft Edge-Browser zum Authentifizieren Ihrer Anmeldedaten verwenden, stellen Sie möglicherweise fest, 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 der Adressleiste des Edge-Browsers edge://net-internals/#hsts ein.

  2. Gehen Sie zum Abschnitt Sicherheitsrichtlinien für die Domain löschen.

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

Von Google Cloud abmelden

  1. Klicken Sie auf Cloud Code und maximieren Sie dann Hilfe und Feedback.
  2. Klicken Sie auf Von Google Cloud abmelden. Wenn Sie dazu aufgefordert werden, wählen Sie Abmelden aus.
  3. Alternativ können Sie sich über die Befehlspalette abmelden. Drücken Sie Ctrl/Cmd + Shift + P oder Ansicht > Befehlspalette und klicken Sie 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.

    Name des aktiven Projekts in der 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 Projekte zu filtern.

Anmeldedaten für die lokale Fehlerbehebung in Anwendungen authentifizieren

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

Wenn Sie Ihre Anmeldedaten nicht für das Debugging von Anwendungen authentifizieren, wird in Ihrer IDE eine Fehlermeldung angezeigt, wenn Sie versuchen, eine lokale Anwendung auszuführen bzw. zu debuggen, die versucht, eine Google API aufzurufen.

Führen Sie die folgenden Schritte aus, um Ihre Anmeldedaten für die lokale Fehlerbehebung in 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 die lokale Fehlerbehebung abgeschlossen haben, 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.