Connessione del client SQL Server tramite l'immagine Docker del proxy di autenticazione Cloud SQL

Questa pagina descrive come connettere un client sqlcmd all'istanza Cloud SQL da una macchina client che esegue Linux o da un'istanza Linux di Compute Engine utilizzando l'immagine Docker del proxy di autenticazione Cloud SQL.

Prima di iniziare

Devi avere:

Connetti un client sqlcmd utilizzando l'immagine Docker del proxy di autenticazione Cloud SQL

Per connetterti utilizzando l'immagine Docker del proxy di autenticazione Cloud SQL:

  1. Abilita l'API Cloud SQL Admin, se non è già abilitata.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

    Abilitare l'API

  2. Se utilizzi un'istanza Compute Engine, preparala:
    1. Visualizza le proprietà dell'istanza Compute Engine: 
      gcloud compute instances describe [GCE_INSTANCE_NAME]
    2. Verifica gli ambiti abilitati nell'istanza.

      L'autenticazione tramite ambiti richiede entrambi gli ambiti seguenti:

      • https://www.googleapis.com/auth/sqlservice.admin
      • https://www.googleapis.com/auth/devstorage.read_write

      In alternativa, l'ambito https://www.googleapis.com/auth/cloud-platform abilita tutte le API Google Cloud.

      Se la tua istanza Compute Engine non dispone degli ambiti corretti, puoi aggiornarla per includerli. Per saperne di più, consulta la documentazione di Compute Engine.

    3. Apri una connessione terminale all'istanza seguendo le istruzioni in Connessione alle istanze Linux.
  3. Installa il client sqlcmd sull'istanza Compute Engine o sulla macchina client, se non è già installato.
  4. Se necessario, installa il client Docker: 
    curl https://get.docker.com | sh
sudo usermod -aG docker $USER

    Se utilizzi un'istanza Compute Engine ottimizzata per i container, il client Docker è già installato.

  5. Installa l'immagine Docker del Cloud SQL Auth Proxy da Google Container Registry. 
    docker pull gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.25.4
  6. Se esegui l'immagine Docker di Cloud SQL Auth Proxy su una macchina locale (non un'istanza Compute Engine) o la tua istanza Compute Engine non dispone degli ambiti corretti, crea un account di servizio Google Cloud Platform.
    1. Nella Google Cloud console, vai alla pagina Service account.

      Vai ad Account di servizio

    2. Seleziona il progetto che contiene l'istanza Cloud SQL.
    3. Fai clic su Crea service account.
    4. Nel campo Nome service account, inserisci un nome descrittivo per il account di servizio.
    5. Modifica l'ID service account con un valore univoco e riconoscibile, quindi fai clic su Crea e continua.
    6. Fai clic sul campo Seleziona un ruolo e seleziona uno dei seguenti ruoli:
      • Cloud SQL > Cloud SQL Client
      • Cloud SQL > Cloud SQL Editor
      • Cloud SQL > Cloud SQL Admin

    7. Fai clic su Fine per completare la creazione del service account.
    8. Fai clic sul menu Azioni per il nuovo account di servizio e seleziona Gestisci chiavi.
    9. Fai clic sul menu a discesa Aggiungi chiave e poi su Crea nuova chiave.
    10. Verifica che il tipo di chiave sia JSON, poi fai clic su Crea.

      Il file della chiave privata viene scaricato sul computer. Puoi spostarlo in un'altra posizione. Mantieni al sicuro il file di chiave.

    Fornisci il percorso del file della chiave come "PATH_TO_KEY_FILE" quando avvii il proxy di autenticazione Cloud SQL.

  7. Vai alla pagina Istanze Cloud SQL nella console Google Cloud .

    Vai a Istanze Cloud SQL

  8. Seleziona l'istanza per aprire la pagina Dettagli istanza e copia il Nome connessione istanza.

    Ad esempio: myproject:us-central1:myinstance.

  9. Avvia il proxy di autenticazione Cloud SQL.

    A seconda della lingua e dell'ambiente, puoi avviare il proxy di autenticazione Cloud SQL utilizzando socket TCP o socket Unix. I socket Unix non sono supportati per le applicazioni scritte nel linguaggio di programmazione Java o per l'ambiente Windows.

    Socket TCP

    docker run -d \
  -v <PATH_TO_KEY_FILE>:/path/to/service-account-key.json \
  -p 127.0.0.1:1433:1433 \
  gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.25.4 \
  --credentials-file /path/to/service-account-key.json <INSTANCE_CONNECTION_NAME>

    Se utilizzi le credenziali fornite dall'istanza Compute Engine, non includere il parametro --credentials-file e la riga -v <PATH_TO_KEY_FILE>:/path/to/service-account-key.json.

    Specifica sempre il prefisso 127.0.0.1 in -p in modo che il Cloud SQL Auth Proxy non sia esposto all'esterno dell'host locale. Il valore "0.0.0.0" nel parametro instances è necessario per rendere la porta accessibile dall'esterno del container Docker.

    Socket Unix

    docker run -d -v /cloudsql:/cloudsql \
  -v <PATH_TO_KEY_FILE>:/path/to/service-account-key.json \
  gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.25.4 //
  --unix-socket=/cloudsql \
  --credentials-file /path/to/service-account-key.json <INSTANCE_CONNECTION_NAME>

    Se utilizzi le credenziali fornite dall'istanza Compute Engine, non includere il parametro --credentials-file e la riga -v <PATH_TO_KEY_FILE>:/path/to/service-account-key.json.

    Se utilizzi un'immagine ottimizzata per i container, utilizza una directory scrivibile al posto di /cloudsql, ad esempio: 

    -v /mnt/stateful_partition/cloudsql:/cloudsql

    Puoi specificare più di un'istanza, separata da virgole. Puoi anche utilizzare i metadati di Compute Engine per determinare dinamicamente le istanze a cui connetterti. Scopri di più sui parametri proxy.

  10. Avvia il client:

    La stringa di connessione che utilizzi dipende dal fatto che tu abbia avviato il Cloud SQL Auth Proxy utilizzando un socket TCP o Docker.

    Socket TCP

    1. Avvia il client sqlcmd: 
      sqlcmd -S tcp:127.0.0.1,1433 -U USERNAME -P PASSWORD

      Quando ti connetti utilizzando i socket TCP, il proxy di autenticazione Cloud SQL viene eseguito tramite 127.0.0.1.

    2. Se richiesto, inserisci la password.
    3. Viene visualizzato il prompt sqlcmd.
Hai bisogno di aiuto? Per assistenza nella risoluzione dei problemi del proxy, consulta Risoluzione dei problemi relativi alle connessioni del proxy di autenticazione Cloud SQL o la nostra pagina Assistenza Cloud SQL.

Mantenere aggiornata l'immagine Docker del Cloud SQL Auth Proxy

L'immagine Docker del proxy di autenticazione Cloud SQL si basa su una versione specifica del proxy di autenticazione Cloud SQL. Quando diventa disponibile una nuova versione del Cloud SQL Auth Proxy, esegui il pull della nuova versione dell'immagine Docker del Cloud SQL Auth Proxy per mantenere aggiornato il tuo ambiente. Puoi visualizzare la versione attuale del proxy di autenticazione Cloud SQL controllando la pagina delle release di GitHub del proxy di autenticazione Cloud SQL.

Passaggi successivi