Gestisci i secret con Secret Manager in Cloud Code for VS Code

Con Secret Manager di Cloud Code integrazione, puoi creare, visualizzare, aggiornare e utilizzare i secret nel tuo IDE senza archiviarli nel codebase.

Questa pagina descrive come accedere a Secret Manager nel tuo IDE e come puoi iniziare a creare e gestire i secret.

Abilita API Secret Manager

Quando gestisci i secret con Cloud Code, i secret vengono archiviati in modo sicuro in Secret Manager e possono essere recuperati in modo programmatico quando che li rappresentano. Ti serve solo l'API Secret Manager abilitata e il software giusto autorizzazioni per gestire i secret:

  1. Assicurati di lavorare nel progetto in cui si trova il codice dell'applicazione risiede. Il secret deve trovarsi nello stesso progetto del codice dell'applicazione.

  2. Fai clic su Cloud Code ed espandi Explorer di Secret Manager.

  3. Se non hai abilitato l'API Secret Manager, fai clic su Abilita l'API Secret Manager nell'explorer di Secret Manager.

Crea secret

Per creare un secret utilizzando l'explorer di Secret Manager, segui questi passaggi passaggi:

  1. Nel tuo IDE, fai clic su Cloud Code ed espandi Explorer di Secret Manager.

  2. Fai clic su add Crea secret nella Explorer di Secret Manager.

    Nella finestra di dialogo Crea secret, imposta il progetto, il nome, il valore e regione e specifica etichette per organizzare i tuoi secret.

In alternativa, puoi creare un secret utilizzando l'editor:

  1. Apri un file contenente il testo da archiviare come secret nell'editor.
  2. Evidenzia il testo da archiviare come secret, fai clic con il tasto destro del mouse, quindi fai clic su Crea il secret in Secret Manager.
  3. Nella finestra di dialogo Crea secret, personalizza il progetto del secret, nome, valore, regione ed etichette.

Crea nuove versioni dei secret

Per creare una nuova versione di un secret utilizzando Secret Manager, segui questi passaggi:

  1. Fai clic con il pulsante destro del mouse su un secret esistente e scegli Crea versione secret.

  2. Nella finestra di dialogo Crea versione, imposta il nuovo valore del secret esistente utilizzando il campo Valore secret o importando un file.

  3. Per rimuovere tutte le versioni precedenti del secret e conservare solo la nuova versione che stai creando, scegli Disattiva tutte le versioni precedenti.

  4. Fai clic su Crea versione. La tua versione è stata aggiunta e puoi vedere l'ultima versione del secret e le versioni precedenti elencate in Versioni menu a discesa.

In alternativa, puoi creare una nuova versione di un secret nell'editor:

  1. Nell'editor, apri un file ed evidenzia il testo da archiviare come secret.

  2. Fai clic con il tasto destro del mouse sul testo evidenziato e scegli Aggiungi versione al secret in Secret Manager.

Gestisci le versioni dei secret

Per abilitare, disabilitare o eliminare una versione di un secret, fai clic con il tasto destro del mouse sul secret e seleziona il comando per l'azione che vuoi eseguire. Per attivate dei secret, puoi visualizzare anche il valore della versione.

Visualizza secret

Per visualizzare i secret, selezionane uno nell'explorer di Secret Manager dall'elenco. Dettagli del secret come nome, criterio di replica e creazione il timestamp e l'ID risorsa sono elencati sotto il nome del secret.

Visualizza i secret nella console Google Cloud

In alternativa, puoi visualizzare i secret nella console Google Cloud facendo clic con il tasto destro del mouse il secret nell'explorer di Secret Manager e facendo clic su Apri in Google Cloud.

Fai clic con il tasto destro del mouse sul secret in Secret Manager per visualizzare l'opzione Apri nella console Google Cloud. Il menu a discesa delle proprietà è visibile anche nella vista di Secret Manager.

Visualizza i secret in Kubernetes Explorer

Per visualizzare i secret in Explorer Kubernetes, segui questi passaggi:

  1. Fai clic su Cloud Code ed espandi Kubernetes esploratore.
  2. Espandi il cluster, quindi espandi Secret.
  3. Espandi il secret per visualizzarne i dettagli.

Accedi ai secret dalla tua applicazione

Una volta creato il secret, puoi includerlo nel codice e configurarlo autenticazione.

Per accedere a un secret dalla tua applicazione:

  1. Installa la libreria client di Secret Manager.

    1. Fai clic su Cloud Code ed espandi Explorer delle API Cloud.

    2. Espandi Cloud Security > API Secret Manager e segui le istruzioni le istruzioni nella sezione Installa libreria client per la lingua che stai utilizzando.

  2. Personalizza e includi snippet di codice pertinente nel codice della tua applicazione.

    Seleziona il secret per ottenere il nome di versione del secret da utilizzare nel codice nel riquadro Secret Manager, fai clic con il tasto destro del mouse e scegli Copia ID risorsa.

  3. Per completare la configurazione dell'autenticazione, segui le librerie client guida all'autenticazione:

    • Sviluppo locale: se stai sviluppando in un cluster locale (ad esempio minikube o Docker Desktop) o un emulatore locale, dovresti completare i passaggi illustrati nell' Sezione Sviluppo locale pertinenti al tuo flusso di lavoro.
    • Sviluppo remoto: se utilizzi un cluster GKE o Cloud Run nella tua applicazione, devi completare i passaggi illustrati in alla sezione Sviluppo remoto pertinenti al tuo flusso di lavoro, incluse le impostazioni istruzioni per la configurazione dei ruoli richiesti nel tuo account di servizio.

Aggiungi un secret come variabile di ambiente

Per aggiungere un secret Kubernetes esistente al deployment come variabile di ambiente:

  1. Fai clic su Cloud Code ed espandi Kubernetes esploratore.
  2. Espandi il cluster minikube e i Secret.
  3. Fai clic con il tasto destro del mouse su un secret che rappresenta un oggetto deployment, quindi fai clic su Aggiungi secret come variabile di ambiente.

Monta un secret come volume

Per montare un secret Kubernetes esistente come volume nel container del deployment, segui questi passaggi:

  1. Fai clic su Cloud Code ed espandi Kubernetes esploratore.
  2. Espandi il cluster minikube e i Secret.
  3. Fai clic con il tasto destro del mouse su un secret che rappresenta un oggetto deployment, quindi fai clic su Monta secret come volume.

Elimina secret

Per eliminare un secret utilizzando Secret Manager in Cloud Code, segui questi passaggi:

  1. Fai clic su Cloud Code ed espandi Explorer di Secret Manager.

  2. Fai clic con il tasto destro del mouse su un secret esistente e seleziona Apri nella console Cloud.

  3. Nella pagina Dettagli secret, fai clic su ELIMINA e segui le istruzioni per per eliminare il secret.

Richiedi assistenza

Per inviare feedback, segnala problemi su GitHub o fai una domanda Stack Overflow.