Gestisci le API e le librerie Cloud in Cloud Code for IntelliJ

Puoi accedere ai prodotti e ai servizi Google Cloud dal tuo codice utilizzando le API Cloud. Queste API Cloud espongono una semplice interfaccia REST JSON che puoi chiamare tramite librerie client.

Questo documento descrive come abilitare le API Cloud e aggiungere le librerie client di Cloud al tuo progetto.

Esplora le API Cloud

Per esplorare tutte le API Google Cloud disponibili nel tuo IDE, segui questi passaggi:

  1. Vai a Strumenti > Google Cloud Code > API Cloud.

  2. La finestra Gestisci API Google Cloud raggruppa le API Cloud per categoria. Puoi anche utilizzare la barra di ricerca delle API di ricerca per trovare API specifiche.

    Explorer API Cloud che mostra l'elenco delle API Cloud.

  3. Fai clic su un'API per visualizzare ulteriori dettagli, ad esempio lo stato, le istruzioni di installazione specifiche per i linguaggi per le librerie client corrispondenti e la documentazione pertinente.

Abilita Cloud APIs

Per abilitare le API Cloud per un progetto utilizzando i dettagli dell'API, segui questi passaggi:

  1. Nella visualizzazione dei dettagli dell'API Cloud, seleziona un progetto Google Cloud per cui vuoi abilitare l'API Cloud.

  2. Fai clic su Abilita API.

    Se l'API è abilitata, viene visualizzato un messaggio per confermare la modifica.

Aggiungi le librerie client di Cloud

Per aggiungere librerie al tuo progetto in IntelliJ, segui questi passaggi:

Per i progetti Maven Java

  1. Vai a Strumenti > Google Cloud Code > API Cloud.
  2. La sezione Installa libreria client della finestra di dialogo Gestisci API Google Cloud mostra le librerie supportate.

  3. Seleziona il tipo di libreria preferito come libreria client di Google Cloud (consigliato per la maggior parte dei progetti) o Java Spring Google Cloud (opzione consigliata se il progetto utilizza Java Spring).
  4. Segui le altre istruzioni nella Installa libreria client nel tuo IDE, se applicabile.
  5. Al termine, fai clic su Chiudi.

Per tutti gli altri progetti

  1. Vai a Strumenti > Google Cloud Code > API Cloud.
  2. La sezione Installa libreria client della finestra di dialogo Gestisci API Google Cloud mostra le librerie supportate.

  3. Per installare l'API, segui le istruzioni di installazione elencate nella pagina dei dettagli dell'API per la tua lingua preferita.

    Se stai sviluppando un'applicazione Java, devi anche specificare la tua preferenza di libreria come libreria client di Google Cloud (opzione consigliata) o Java Spring Google Cloud.

  4. Al termine, fai clic su Chiudi.

Utilizzare esempi di codice API

Per cercare e utilizzare esempi di codice per ogni API in Explorer API, segui questi passaggi:

  1. Vai a Strumenti > Google Cloud Code > API Cloud.

  2. Per aprire la visualizzazione dei dettagli, fai clic sul nome di un'API.

  3. Per visualizzare esempi di codice per l'API, fai clic sulla scheda Esempi di codice.

  4. Per filtrare l'elenco degli esempi, digita il testo da cercare o seleziona una lingua di programmazione dal menu a discesa Lingua.

Configura l'autenticazione

Dopo aver abilitato le API richieste e aggiunto le librerie client necessarie, devi configurare l'applicazione affinché venga autenticata. La configurazione dipende dal tipo di sviluppo e dalla piattaforma su cui viene eseguita.

Una volta completati i passaggi di autenticazione pertinenti, l'applicazione può autenticarsi ed è pronta per il deployment.

Sviluppo locale

Macchina locale

Cloud Code garantisce che le credenziali predefinite dell'applicazione (ADC) siano impostate se hai eseguito l'accesso a Google Cloud tramite il tuo IDE. Se non accedi con Cloud Code, esegui gcloud auth application-default login manualmente.

Minikube

  1. Cloud Code garantisce che le credenziali predefinite dell'applicazione (ADC) siano impostate se hai eseguito l'accesso a Google Cloud tramite il tuo IDE. Se non accedi con Cloud Code, esegui gcloud auth application-default login manualmente.
  2. Avvia minikube con minikube start --addons gcp-auth. In questo modo l'ADC viene montato nei pod. Per una guida dettagliata all'autenticazione di minikube per Google Cloud, consulta la documentazione di minikube gcp-auth.

Altri cluster K8s locali

  1. Cloud Code garantisce che le credenziali predefinite dell'applicazione (ADC) siano impostate se hai eseguito l'accesso a Google Cloud tramite il tuo IDE. Se non accedi con Cloud Code, esegui gcloud auth application-default login manualmente.
  2. Monta la directory gcloud locale nei tuoi pod Kubernetes modificando la specifica del pod nei manifest del pod o del deployment, in modo che le librerie client di Google Cloud possano trovare le tue credenziali. Esempio di configurazione di pod Kubernetes:
    apiVersion: v1
    kind: Pod
    metadata:
      name: my-app
      labels:
        name: my-app
    spec:
      containers:
      - name: my-app
        image: gcr.io/google-containers/busybox
        ports:
          - containerPort: 8080
        volumeMounts:
          - mountPath: /root/.config/gcloud
            name: gcloud-volume
      volumes:
        - name: gcloud-volume
          hostPath:
            path: /path/to/home/.config/gcloud

Cloud Run

Cloud Code garantisce che le credenziali predefinite dell'applicazione (ADC) siano impostate se hai eseguito l'accesso a Google Cloud tramite il tuo IDE. Se non accedi con Cloud Code, esegui gcloud auth application-default login manualmente.

Sviluppo remoto

Google Kubernetes Engine


A seconda dell'ambito del progetto, puoi scegliere la modalità di autenticazione dei servizi Google Cloud su GKE:
  • (Solo sviluppo)
    1. Crea un cluster GKE con le seguenti impostazioni:
      • Assicurati di utilizzare l'account di servizio utilizzato da GKE per impostazione predefinita, l'account di servizio predefinito di Compute Engine e che gli Ambiti di accesso siano impostati su Consenti l'accesso completo a tutte le API Cloud (entrambe le impostazioni sono accessibili nella sezione Pool di nodi > Sicurezza).
        Poiché l'account di servizio Compute Engine è condiviso da tutti i carichi di lavoro di cui è stato eseguito il deployment sul nodo, questo metodo esegue l'overprovisioning delle autorizzazioni e deve essere utilizzato solo per lo sviluppo.
      • Assicurati che Workload Identity non sia abilitato nel tuo cluster (nella sezione Cluster > Sicurezza).
    2. Assegna i ruoli necessari all'account di servizio predefinito di Compute Engine:
  • (Consigliata per la produzione)
    1. Configura il tuo cluster e la tua applicazione GKE con Workload Identity per autenticare i servizi Google Cloud su GKE. In questo modo il tuo account di servizio Kubernetes verrà associato all'account di servizio Google.
    2. Configura il tuo deployment Kubernetes in modo che faccia riferimento all'account di servizio Kubernetes impostando il campo .spec.serviceAccountName nel file YAML del deployment di Kubernetes.
      Se stai lavorando su un'app creata da un modello Cloud Code, questo file si trova nella cartella kubernetes-manifests.
    3. Se il servizio Google Cloud a cui stai tentando di accedere richiede ruoli aggiuntivi, concedili per l'account di servizio Google che stai utilizzando per sviluppare la tua app:

Cloud Run


  1. Per creare un nuovo account di servizio univoco per il deployment della tua applicazione Cloud Run, seleziona il progetto in cui è archiviato il tuo secret nella pagina Account di servizio.

    Vai alla pagina Account di servizio

  2. Fai clic su Crea account di servizio.
  3. Nella finestra di dialogo Crea account di servizio, inserisci un nome descrittivo per l'account di servizio.
  4. Modifica l'ID account di servizio in un valore univoco e riconoscibile, quindi fai clic su Crea.
  5. Se il servizio Google Cloud a cui stai tentando di accedere richiede ulteriori ruoli, concedili, fai clic su Continua e poi su Fine.
  6. Per aggiungere il tuo account di servizio Kubernetes alla configurazione del deployment, vai a Esegui > Modifica configurazioni e specifica il tuo account di servizio nel campo Nome servizio.

Cloud Run


A seconda dell'ambito del progetto, puoi scegliere la modalità di autenticazione dei servizi Google Cloud su GKE:
  • (Solo sviluppo)
    1. Crea un cluster GKE con le seguenti impostazioni:
      • Assicurati di utilizzare l'account di servizio utilizzato da GKE per impostazione predefinita, l'account di servizio predefinito di Compute Engine e che gli Ambiti di accesso siano impostati su Consenti l'accesso completo a tutte le API Cloud (entrambe le impostazioni sono accessibili nella sezione Pool di nodi > Sicurezza).
        Poiché l'account di servizio Compute Engine è condiviso da tutti i carichi di lavoro di cui è stato eseguito il deployment sul nodo, questo metodo esegue l'overprovisioning delle autorizzazioni e deve essere utilizzato solo per lo sviluppo.
      • Assicurati che Workload Identity non sia abilitato nel tuo cluster (nella sezione Cluster > Sicurezza).
    2. Assegna i ruoli necessari all'account di servizio predefinito di Compute Engine:
  • (Consigliata per la produzione)
    1. Configura il tuo cluster e la tua applicazione GKE con Workload Identity per autenticare i servizi Google Cloud su GKE. In questo modo il tuo account di servizio Kubernetes verrà associato all'account di servizio Google.
    2. Per aggiungere il tuo account di servizio Kubernetes alla configurazione del deployment, vai a Esegui > Modifica configurazioni, quindi specifica il tuo account di servizio Kubernetes nel campo Nome servizio.
    3. Se il servizio Google Cloud a cui stai tentando di accedere richiede ruoli aggiuntivi, concedili per l'account di servizio Google che stai utilizzando per sviluppare la tua app:

Sviluppo remoto con autorizzazioni di Secret Manager abilitate

Se stai sviluppando in remoto, utilizzando un account di servizio per l'autenticazione e la tua applicazione utilizza i secrets, devi completare alcuni passaggi aggiuntivi oltre alle istruzioni per lo sviluppo da remoto. Questi passaggi assegnano al tuo account di servizio Google il ruolo necessario per accedere a un determinato secret di Secret Manager:

  1. Per aprire la finestra dello strumento Secret Manager, vai a Strumenti > Google Cloud Code > Secret Manager.

  2. Seleziona il secret a cui vuoi accedere nel tuo codice.

  3. Fai clic sulla scheda Autorizzazioni, quindi configura le autorizzazioni del secret facendo clic su Modifica Modifica autorizzazione.

    Scheda Autorizzazioni selezionata all'interno di Secret Manager e l'icona Modifica autorizzazioni evidenziata

    La console Google Cloud si apre in una nuova finestra del browser web che mostra la pagina di configurazione di Secret Manager del tuo secret.

  4. Nella console Google Cloud, fai clic sulla scheda Autorizzazioni, quindi su Concedi l'accesso.

  5. Nel campo Nuove entità, inserisci il tuo account di servizio.

  6. Nel campo a discesa Seleziona un ruolo, seleziona il ruolo Accessore ai secret di Secret Manager.

  7. Al termine, fai clic su Salva.

    Il tuo account di servizio dispone dell'autorizzazione per accedere a questo secret.

Ricevi assistenza

Per inviare un feedback o segnalare un problema nell'IDE IntelliJ, vai a Strumenti > Cloud Code > Guida / Informazioni > Invia feedback o segnala un problema per segnalare un problema su GitHub oppure fai una domanda su Stack Overflow.