Hier erfahren Sie, wie Sie mithilfe der Secret Manager-Integration von Cloud Code Geheimnisse erstellen und verwalten.
Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:
Hinweise
-
In the Google Cloud console, go to the project selector page.
-
Select or create a Google Cloud project.
Klicken Sie in der Cloud Code-Statusleiste auf den Namen des aktiven Projekts.
Wählen Sie im angezeigten Menü „Schnellauswahl“ die Option Neue Anwendung und dann Cloud Run-Anwendung aus.
Wählen Sie aus der Liste der Cloud Run-Beispiele Python (Flask): Cloud Run aus.
Wählen Sie einen Ordner für das Beispiel aus und klicken Sie auf Neue Anwendung erstellen.
- Klicken Sie auf
Secret Manager und warten Sie einen Moment, bis die Seite geladen ist. - Wenn Sie aufgefordert werden, Cloud Shell für Google Cloud API-Aufrufe zu autorisieren, Klicken Sie auf Autorisieren.
- Klicken Sie auf Add (Hinzufügen).
Erstellen Secret - Wenn Sie dazu aufgefordert werden, wählen Sie Ihr Google Cloud-Projekt aus der Drop-down-Auswahl aus.
- Aktivieren Sie die Secret Manager API, wenn Sie dazu aufgefordert werden.
Geben Sie auf dem Tab Secret Manager – Secret erstellen den folgenden Wert in das Feld Name ein:
my-secret
Geben Sie im Feld Secret-Wert Folgendes ein:
Hello secret!
Klicken Sie auf Secret erstellen und bestätigen Sie, dass das Secret erfolgreich erstellt wurde.
Öffnen Sie das
Cloud API -Ansicht und wählen SieSecret Manager API Daraufhin wird der Google Cloud API-Tab „Detail“ mit der Secret Manager API als Überschrift angezeigt.
Klicken Sie im Abschnitt Clientbibliothek installieren auf den Tab Python und Klicken Sie auf play_arrow Im Terminal ausführen. Dadurch wird die
google-cloud-secret-manager
-Clientbibliothek installiert.Öffnen Sie
requirements.txt und fügen Sie am Ende der Datei die folgende Zeile hinzu:google-cloud-secret-manager==2.1.0
Deine Änderungen werden automatisch gespeic
Öffnen Sie zum Abrufen des aktuellen Werts Ihres Secrets
app.py . Kopieren Sie die folgende Funktion und fügen Sie sie nach der Funktion „hello“ ein: <ph type="x-smartling-placeholder"></ph> :def access_secret_version(secret_version_id): """Return the value of a secret's version""" from google.cloud import secretmanager # Create the Secret Manager client. client = secretmanager.SecretManagerServiceClient() # Access the secret version. response = client.access_secret_version(name=secret_version_id) # Return the decoded payload. return response.payload.data.decode('UTF-8')
Ersetzen Sie zum Aufrufen der Funktion
access_secret_version
dieNachrichtenvariable durch Folgendes:message = access_secret_version("<SECRET_VERSION_ID>")
Wenn der Tab Secret Manager – Secret erstellen noch geöffnet ist, file_copy kopieren Sie die ID.
Sie können die ID einer Secret-Version jederzeit unter
Secret Manager > [SECRET_NAME] > „Versionen“ abrufen. Bewegen Sie den Mauszeiger auf die Version und klicken Sie auf > Ressourcen-ID kopieren.Ersetzen Sie den Platzhalter
durch die kopierte Versions-ID, um sie hinzuzufügen.<SECRET_VERSION_ID>
- Rufen Sie über die Statusleiste das Menü
Cloud Code auf. - Wenn Sie Ihren Dienst im Emulator erstellen und bereitstellen möchten, wählen Sie
Auf Cloud Run-Emulator ausführen aus. - Klicken Sie auf dem Tab „Im Cloud Run-Emulator ausführen/debuggen“ auf Ausführen.
Wenn Sie die Konfiguration zum ersten Mal ausführen, kann dieser Vorgang bis 5 Minuten dauern. Im Bereich
Ausgabe wird der Fortschritt angezeigt, während die Anwendung erstellt und bereitgestellt wird.Starten Sie die Anwendung, nachdem sie erstellt wurde. Klicken Sie dazu auf den Localhost-Link, erscheint in Ihren
Ausgabe . Der Wert Ihres Secrets wird unter der Erfolgsgrafik angezeigt.- Klicken Sie auf die Ansicht
Secret Manager . - Erweitern Sie Ihr Secret, indem Sie darauf klicken.
- Klicken Sie im Ordner Versionen mit der rechten Maustaste auf die gewünschte nummerierte Version. um den Wert zu sehen, und wählen Sie Versionswert anzeigen aus.
- Klicken Sie auf das
Vertraulich Administrator . - Klicken Sie mit der rechten Maustaste auf den Namen des Secrets und wählen Sie Secret-Version erstellen aus.
- Geben Sie auf dem Tab Secret Manager – Version erstellen einen neuen Wert ein und klicken Sie auf Version erstellen.
- Nachdem der Tab Secret Manager – Secret erstellen geöffnet wurde, klicken Sie auf file_copy Kopieren, um die ID zu kopieren.
- Um die neuere Versions-ID hinzuzufügen, ersetzen Sie die aktuelle Version, die in der Nachrichtenvariable in
app.py angezeigt wird, durch die neuere Versions-ID, die Sie kopiert haben. - Klicken Sie auf Cloud Code und maximieren Sie den Bereich Secret Manager.
- Erweitern Sie Ihr Secret, indem Sie darauf klicken.
- Klicken Sie im Ordner Versionen mit der rechten Maustaste auf die nummerierte Version, die Sie aktualisieren möchten. deaktivieren.
- Wählen Sie Version deaktivieren aus.
- Klicken Sie auf Cloud Code und maximieren Sie den Bereich Secret Manager.
- Erweitern Sie Ihr Secret, indem Sie darauf klicken.
- Klicken Sie im Ordner Versionen mit der rechten Maustaste auf die Version, die Sie löschen möchten.
- Wählen Sie Version löschen aus.
- Klicken Sie auf . Cloud Code und maximieren Sie dann den Abschnitt Kubernetes.
- Bewegen Sie den Mauszeiger auf den Clusternamen und klicken Sie dann auf open_in_new (In Google Cloud Console öffnen).
- Klicken Sie auf Löschen und dann noch einmal auf Löschen.
Rufen Sie die Seite „Projekte“ in der Google Cloud Console auf:
Wählen Sie das Projekt aus, das Sie für diese Kurzanleitung erstellt haben, und klicken Sie dann auf Löschen.
Geben Sie die Projekt-ID ein und klicken Sie auf Beenden.
Das Projekt wird beendet und der Löschvorgang geplant.
Cloud Run-Dienst erstellen
Verwenden Sie den Cloud Shell-Editor als Umgebung zum Erstellen Ihres Cloud Run-Dienstes und Secrets. Im Editor sind die für die Cloud-Entwicklung erforderlichen Tools bereits vorinstalliert.
So erstellen Sie Ihren Dienst:
Nachdem der Cloud Shell-Editor Ihren Dienst in einen neuen Arbeitsbereich geladen hat, können Sie die Dateien in der
Secret erstellen
Mit Secret Manager können Sie Secrets als binäre Blobs oder Textstrings speichern, verwalten und darauf zugreifen. Secrets werden automatisch verwaltet, sodass Sie sich nicht um virtuelle Maschinen oder Betriebsdienste kümmern müssen.
So erstellen Sie ein Secret mit der Secret Manager-Einbindung von Cloud Code:
Dem Code ein Secret hinzufügen
Secrets eignen sich hervorragend zum Speichern von Konfigurationsinformationen wie Datenbankpasswörtern, API-Schlüsseln oder TLS-Zertifikaten, die eine Anwendung zur Laufzeit benötigt.
Um dem Code ein Secret hinzuzufügen:
In Cloud Run-Emulator ausführen
Führen Sie den Cloud Run-Dienst lokal im Cloud Run-Emulator aus, um das neue Secret zu testen.
Secret-Version ansehen und neue erstellen
In der Secret Manager-Ansicht von Cloud Code erhalten Sie einen schnellen Überblick über die Secrets Ihres Projekts und Aktionen zu deren Verwaltung.
Wert einer Secret-Version ansehen
Beachten Sie, dass Sie eine Secret-Version nicht bearbeiten können. Um den Wert eines Secrets zu aktualisieren, müssen Sie eine neue Version erstellen.
Neue Secret-Version erstellen
Der Wert eines Secrets wird in einer Secret-Version gespeichert. Ein Secret kann viele Versionen haben. Dies ist in Situationen hilfreich, in denen sich ein Secret ändert. Aktualisieren eines Secrets mit einer neuen Version bedeutet, dass Sie Ihren Code nicht aktualisieren müssen.
latest
Secrets ansehen und verwalten
Secret-Version deaktivieren
Secret-Versionen werden nach der Erstellung standardmäßig aktiviert, d. h., auf sie kann zugegriffen werden. Auf ein deaktiviertes Secret kann nicht zugegriffen werden. Sie können den Zugriff aber jederzeit wiederherstellen. jederzeit ändern.
So deaktivieren Sie eine Secret-Version:
Secret-Version löschen
Wenn Sie eine Secret-Version löschen, kann nicht mehr darauf zugegriffen werden. Das Löschen einer Secret-Version kann nicht rückgängig gemacht werden.
Bereinigen
So löschen Sie nur den Cluster, den Sie für diese Kurzanleitung erstellt haben:
So löschen Sie Ihr Projekt und die zugehörigen Ressourcen, einschließlich der Cluster: