Conectar-se ao Cloud SQL para MySQL pelo Google Kubernetes Engine

Console

Criar uma instância com um endereço IP público

1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

   Acesse "Instâncias do Cloud SQL"

2. Clique em Criar instância.
3. Clique em MySQL.
4. Insira quickstart-instance para o ID da instância.
5. Digite a senha do usuário raiz. Salve essa senha para uso futuro.
6. Clique na opção Zona única em Escolher disponibilidade por região e zona.
7. Clique e expanda a seção Mostrar configurações.
8. No menu suspenso Tipo de máquina, selecione Leve.

9. Clique em Criar instância e aguarde até que a instância seja inicializada.

gcloud

Criar uma instância com um endereço IP público

Antes de executar o comando gcloud sql instances create da seguinte maneira, substitua DB_ROOT_PASSWORD pela senha do usuário do banco de dados.

Se quiser, modifique os valores dos seguintes parâmetros:

• --database_version: o tipo e a versão do mecanismo de banco de dados. Se não for especificado, a API padrão será usada. Consulte a documentação das versões de banco de dados do gcloud para ver as versões atuais disponíveis.
• --cpu: o número de núcleos desejados na máquina.
• --memory: valor de número inteiro que indica a quantidade de memória desejada na máquina. Uma unidade de tamanho precisa ser fornecida (por exemplo, 3.072 MB ou 9 GB). Se nenhuma unidade for especificada, é considerado o GB.
• --region: local regional da instância (por exemplo, asia-east1, us-east1). Se não houver especificação, o padrão us-central é usado. Veja a lista completa de regiões.

Execute o comando gcloud sql instances create para criar uma instância do Cloud SQL.

gcloud sql instances create quickstart-instance \
--database-version=MYSQL_8_0 \
--cpu=1 \
--memory=4GB \
--region=us-central1 \
--root-password=DB_ROOT_PASSWORD

Console

Criar uma instância com SSL e endereço IP particular ativados

1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

   Acesse Instâncias do Cloud SQL

2. Clique em Criar instância.
3. Clique em MySQL.
4. Insira quickstart-instance para o ID da instância.
5. Digite a senha do usuário raiz. Salve essa senha para uso futuro.
6. Clique na opção Zona única em Escolher disponibilidade por região e zona.
7. Clique e expanda Mostrar opções de configuração.
8. Em Tipo de máquina, selecione Leve.
9. Em Conexões, selecione IP particular.
10. Selecione padrão no menu suspenso Rede.
11. Se a caixa de diálogo Conexão de acesso a serviços particulares necessária for exibida, clique no botão Configurar conexão.
• Na caixa de diálogo Ativar API Service Networking, clique no botão Ativar API.
• Na caixa de diálogo Alocar um intervalo de IP, selecione Usar um intervalo de IP alocado automaticamente e clique em Continuar.
• Na caixa de diálogo Criar uma conexão, clique em Criar conexão.
12. Desmarque a caixa de seleção IP público para criar uma instância apenas com um IP privado.
13. Clique em Criar instância e aguarde a inicialização da instância.
14. Clique em Conexões.
15. Na seção Segurança, selecione Permitir apenas conexões SSL para ativar conexões SSL.
16. Na caixa de diálogo Ativar SSL, clique em Ativar e reiniciar e aguarde a reinicialização da instância.

gcloud

Criar uma instância com SSL e endereço IP particular ativados

Criar uma instância com um endereço IP privado requer apenas a configuração do acesso a serviços particulares para permitir conexões a partir de outros serviços do Google Cloud, como o GKE.

1. Execute o comando gcloud compute addresses create para alocar um intervalo de IP para uma conexão de acesso a serviços particulares:

gcloud compute addresses create google-managed-services-default \
--global \
--purpose=VPC_PEERING \
--prefix-length=16 \
--description="peering range for Google" \
--network=default

2. Execute o comando gcloud services vpc-peerings connect para criar a conexão de acesso a serviços particulares:

gcloud services vpc-peerings connect \
--service=servicenetworking.googleapis.com \
--ranges=google-managed-services-default \
--network=default

3. Antes de executar o comando gcloud sql instances create para criar uma instância da seguinte maneira, substitua DB_ROOT_PASSWORD pela senha do usuário do banco de dados.

Se quiser, modifique os valores dos seguintes parâmetros:

• --database_version: o tipo e a versão do mecanismo de banco de dados. Se não for especificado, a API padrão será usada. Consulte as versões do banco de dados do gcloud para ver uma lista das versões disponíveis no momento.
• --cpu: o número de núcleos na máquina;
• --memory: um número inteiro que indica quanta memória incluir na máquina. Uma unidade de tamanho pode ser fornecida (por exemplo, 3.072 MB ou 9 GB). Se nenhuma unidade for especificada, serão considerados GB.
• --region: local regional da instância (por exemplo, asia-east1, us-east1). Se não for especificado, o padrão us-central1 será utilizado. Veja a lista completa de regiões.

Execute o comando gcloud sql instances create para criar uma instância do Cloud SQL com um endereço IP particular.

 gcloud beta sql instances create quickstart-instance \
--database-version=MYSQL_8_0 \
--cpu=1 \
--memory=4GB \
--region=us-central1 \
--root-password=DB_ROOT_PASSWORD \
--no-assign-ip \
--network=default

4. Execute o comando gcloud sql instances patch para permitir apenas conexões SSL para a instância.

gcloud sql instances patch quickstart-instance --require-ssl

Go

O aplicativo de amostra implantado se conectará à instância do Cloud SQL usando o proxy do Cloud SQL em execução em um padrão de arquivo secundário do Kubernetes. Esse padrão é realizado com a implantação de uma carga de trabalho com um contêiner extra que compartilha o mesmo pod do Kubernetes que o contêiner do aplicativo de amostra.

1. Para saber o nome da conexão da instância do Cloud SQL, execute o comando gcloud sql instances describe:

   gcloud sql instances describe quickstart-instance --format='value(connectionName)'

2. Atualize o arquivo deployment.yaml no editor do Cloud Shell. Faça as seguintes substituições e edições:
   • Substitua <YOUR_KSA_NAME> por ksa-cloud-sql.
   • Substitua <LOCATION> por us-central1.
   • Substitua <YOUR_PROJECT_ID> pelo ID do projeto.
   • Substitua <YOUR-DB-SECRET> por gke-cloud-sql-secrets.
   • Substitua <INSTANCE_CONNECTION_NAME> pelo nome da conexão da instância do Cloud SQL recuperada do comando gcloud na etapa anterior. O formato é project_id:region:instance_name. O nome da conexão da instância também está visível na página Visão geral da instância do Cloud SQL.
   • Ative o proxy do Cloud SQL Auth para se conectar à instância do Cloud SQL usando o endereço IP particular. Remova a marca de comentário da sinalização "-ip_address_types=PRIVATE" removendo o símbolo de comentário # e o espaço em branco à direita. A sinalização sem comentários ficará assim:

     - "-ip_address_types=PRIVATE"

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gke-cloud-sql-quickstart
   spec:
     selector:
       matchLabels:
         app: gke-cloud-sql-app
     template:
       metadata:
         labels:
           app: gke-cloud-sql-app
       spec:
         serviceAccountName: <YOUR-KSA-NAME>
         containers:
         - name: gke-cloud-sql-app
           # Replace <LOCATION> with your Artifact Registry location (e.g., us-central1).
           # Replace <YOUR_PROJECT_ID> with your project ID.
           image: <LOCATION>-docker.pkg.dev/<YOUR_PROJECT_ID>/gke-cloud-sql-repo/gke-sql:latest
           # This app listens on port 8080 for web traffic by default.
           ports:
           - containerPort: 8080
           env:
           - name: PORT
             value: "8080"
           # This project uses environment variables to determine
           # how you would like to run your application
           # To use the Go Connector (recommended) - use INSTANCE_CONNECTION_NAME (proj:region:instance)
           # To use TCP - Setting INSTANCE_HOST will use TCP (e.g., 127.0.0.1)
           # To use Unix, use INSTANCE_UNIX_SOCKET (e.g., /cloudsql/proj:region:instance)
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "3306"
           # For Automatic IAM Authentication with the Go Connector
           # use DB_IAM_USER instead of DB_USER (recommended)
           # You may also remove the DB_PASS environment variable if
           # you use Automatic IAM Authentication
           - name: DB_USER
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: username
           - name: DB_PASS
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: password
           - name: DB_NAME
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: database
         # If you are using the Go Connector (recommended), you can
         # remove cloud-sql-proxy (everything below this line)
         - name: cloud-sql-proxy
           # This uses the latest version of the Cloud SQL Proxy
           # It is recommended to use a specific version for production environments.
           # See: https://github.com/GoogleCloudPlatform/cloudsql-proxy
           image: gcr.io/cloud-sql-connectors/cloud-sql-proxy:latest
           args:
             # If connecting from a VPC-native GKE cluster, you can use the
             # following flag to have the proxy connect over private IP
             # - "--private-ip"
   
             # If you are not connecting with Automatic IAM, you can delete
             # the following flag.
             - "--auto-iam-authn"
   
             # tcp should be set to the port the proxy should listen on
             # and should match the DB_PORT value set above.
             # Defaults: MySQL: 3306, Postgres: 5432, SQLServer: 1433
             - "--port=3306"
             - "<INSTANCE_CONNECTION_NAME>"
           securityContext:
             # The default Cloud SQL proxy image runs as the
             # "nonroot" user and group (uid: 65532) by default.
             runAsNonRoot: true
   

3. Execute o comando kubectl apply da seguinte maneira no Cloud Shell para implantar o aplicativo de amostra:

   kubectl apply -f deployment.yaml

4. Execute o comando kubectl apply da seguinte maneira para adicionar um balanceador de carga na frente da implantação, para que você possa acessá-lo na Internet:

   kubectl apply -f service.yaml

5. Execute o comando kubectl get da seguinte maneira para ver os detalhes do serviço:

   kubectl get services

6. Copie o endereço IP externo assim que ele ficar disponível nos detalhes do serviço, o que pode levar alguns minutos.
7. Veja o aplicativo de amostra implantado. Abra uma janela do navegador e acesse o endereço IP externo do serviço.

   

Java

O aplicativo de amostra implantado se conectará à instância do Cloud SQL usando o conector Java do Cloud SQL.

1. Para saber o nome da conexão da instância do Cloud SQL, execute o comando gcloud sql instances describe:

   gcloud sql instances describe quickstart-instance --format='value(connectionName)'

2. Atualize o arquivo deployment.yaml no editor do Cloud Shell. Faça as seguintes substituições:
   • <YOUR_KSA_NAME> com ksa-cloud-sql.
   • <LOCATION> com us-central1.
   • <YOUR_PROJECT_ID> pelo ID do projeto.
   • <YOUR-DB-SECRET> com gke-cloud-sql-secrets.
   • <INSTANCE_CONNECTION_NAME> pelo nome da conexão da instância do Cloud SQL recuperada do comando gcloud na etapa anterior. O formato é project_id:region:instance_name. O nome da conexão da instância também está visível na página Visão geral da instância do Cloud SQL.
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gke-cloud-sql-quickstart
   spec:
     selector:
       matchLabels:
         app: gke-cloud-sql-app
     template:
       metadata:
         labels:
           app: gke-cloud-sql-app
       spec:
         # For more information about using Kubernetes service accounts see: 
         # https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts
         serviceAccountName: <YOUR-KSA-NAME> # TODO(developer): replace this value.
         containers:
         - name: gke-cloud-sql-app
           # Replace <LOCATION> with your Artifact Registry location (e.g., us-central1).
           # Replace <YOUR_PROJECT_ID> with your project ID.
           image: <LOCATION>-docker.pkg.dev/<YOUR_PROJECT_ID>/gke-cloud-sql-repo/gke-sql:latest
           # This app listens on port 8080 for web traffic by default.
           ports:
           - containerPort: 8080
           env:
           - name: PORT
             value: "8080"
           - name: INSTANCE_CONNECTION_NAME
             value: <INSTANCE_CONNECTION_NAME>
           - name: DB_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "3306"  
           - name: DB_USER
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: username
           - name: DB_PASS
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: password
           - name: DB_NAME
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: database
   

3. Execute o comando kubectl apply da seguinte maneira no Cloud Shell para implantar o aplicativo de amostra:

   kubectl apply -f deployment.yaml

4. Execute o comando kubectl apply da seguinte maneira para adicionar um balanceador de carga na frente da implantação, para que você possa acessá-lo na Internet:

   kubectl apply -f service.yaml

5. Execute o comando kubectl get da seguinte maneira para ver os detalhes do serviço:

   kubectl get services

6. Copie o endereço IP externo assim que ele ficar disponível nos detalhes do serviço, o que pode levar alguns minutos.
7. Veja o aplicativo de amostra implantado. Abra uma janela do navegador e acesse o endereço IP externo do serviço.

   

Node.js

O aplicativo de amostra implantado se conectará à instância do Cloud SQL usando o proxy do Cloud SQL em execução em um padrão de arquivo secundário do Kubernetes. Esse padrão é realizado com a implantação de uma carga de trabalho com um contêiner extra que compartilha o mesmo pod do Kubernetes que o contêiner do aplicativo de amostra.

1. Para saber o nome da conexão da instância do Cloud SQL, execute o comando gcloud sql instances describe:

   gcloud sql instances describe quickstart-instance --format='value(connectionName)'

2. Atualize o arquivo deployment.yaml no editor do Cloud Shell. Faça as seguintes substituições e edições:
   • Substitua <YOUR_KSA_NAME> por ksa-cloud-sql.
   • Substitua <LOCATION> por us-central1.
   • Substitua <YOUR_PROJECT_ID> pelo ID do projeto.
   • Substitua <YOUR-DB-SECRET> por gke-cloud-sql-secrets.
   • Substitua <INSTANCE_CONNECTION_NAME> pelo nome da conexão da instância do Cloud SQL recuperada do comando gcloud na etapa anterior. O formato é project_id:region:instance_name. O nome da conexão da instância também está visível na página Visão geral da instância do Cloud SQL.
   • Ative o proxy do Cloud SQL Auth para se conectar à instância do Cloud SQL usando o endereço IP particular. Remova a marca de comentário da sinalização "-ip_address_types=PRIVATE" removendo o símbolo de comentário # e o espaço em branco à direita. A sinalização sem comentários ficará assim:

     - "-ip_address_types=PRIVATE"

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gke-cloud-sql-quickstart
   spec:
     selector:
       matchLabels:
         app: gke-cloud-sql-app
     template:
       metadata:
         labels:
           app: gke-cloud-sql-app
       spec:
         serviceAccountName: <YOUR-KSA-NAME>
         containers:
         - name: gke-cloud-sql-app
           # Replace <LOCATION> with your Artifact Registry location (e.g., us-central1).
           # Replace <YOUR_PROJECT_ID> with your project ID.
           image: <LOCATION>-docker.pkg.dev/<YOUR_PROJECT_ID>/gke-cloud-sql-repo/gke-sql:latest
           # This app listens on port 8080 for web traffic by default.
           ports:
           - containerPort: 8080
           env:
           - name: PORT
             value: "8080"
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "3306"  
           - name: DB_USER
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: username
           - name: DB_PASS
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: password
           - name: DB_NAME
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: database
         - name: cloud-sql-proxy
           # This uses the latest version of the Cloud SQL proxy
           # It is recommended to use a specific version for production environments.
           # See: https://github.com/GoogleCloudPlatform/cloudsql-proxy 
           image: gcr.io/cloud-sql-connectors/cloud-sql-proxy:latest
           args:
             # If connecting from a VPC-native GKE cluster, you can use the
             # following flag to have the proxy connect over private IP
             # - "--private-ip"
   
             # If you are not connecting with Automatic IAM, you can delete
             # the following flag.
             - "--auto-iam-authn"
   
             # tcp should be set to the port the proxy should listen on
             # and should match the DB_PORT value set above.
             # Defaults: MySQL: 3306, Postgres: 5432, SQLServer: 1433
             - "--port=3306"
             - "<INSTANCE_CONNECTION_NAME>"
           securityContext:
             # The default Cloud SQL proxy image runs as the
             # "nonroot" user and group (uid: 65532) by default.
             runAsNonRoot: true
   

3. Execute o comando kubectl apply da seguinte maneira no Cloud Shell para implantar o aplicativo de amostra:

   kubectl apply -f deployment.yaml

4. Execute o comando kubectl apply da seguinte maneira para adicionar um balanceador de carga na frente da implantação, para que você possa acessá-lo na Internet:

   kubectl apply -f service.yaml

5. Execute o comando kubectl get da seguinte maneira para ver os detalhes do serviço:

   kubectl get services

6. Copie o endereço IP externo assim que ele ficar disponível nos detalhes do serviço, o que pode levar alguns minutos.
7. Veja o aplicativo de amostra implantado. Abra uma janela do navegador e acesse o endereço IP externo do serviço.

   

Python

O aplicativo de amostra implantado se conectará à instância do Cloud SQL usando o proxy do Cloud SQL em execução em um padrão de arquivo secundário do Kubernetes. Esse padrão é realizado com a implantação de uma carga de trabalho com um contêiner extra que compartilha o mesmo pod do Kubernetes que o contêiner do aplicativo de amostra.

1. Para saber o nome da conexão da instância do Cloud SQL, execute o comando gcloud sql instances describe:

   gcloud sql instances describe quickstart-instance --format='value(connectionName)'

2. Atualize o arquivo deployment.yaml no editor do Cloud Shell. Faça as seguintes substituições e edições:
   • Substitua <YOUR_KSA_NAME> por ksa-cloud-sql.
   • Substitua <LOCATION> por us-central1.
   • Substitua <YOUR_PROJECT_ID> pelo ID do projeto.
   • Substitua <YOUR-DB-SECRET> por gke-cloud-sql-secrets.
   • Substitua <INSTANCE_CONNECTION_NAME> pelo nome da conexão da instância do Cloud SQL recuperada do comando gcloud na etapa anterior. O formato é project_id:region:instance_name. O nome da conexão da instância também está visível na página Visão geral da instância do Cloud SQL.
   • Ative o proxy do Cloud SQL Auth para se conectar à instância do Cloud SQL usando o endereço IP particular. Remova a marca de comentário da sinalização "-ip_address_types=PRIVATE" removendo o símbolo de comentário # e o espaço em branco à direita. A sinalização sem comentários ficará assim:

     - "-ip_address_types=PRIVATE"

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gke-cloud-sql-quickstart
   spec:
     selector:
       matchLabels:
         app: gke-cloud-sql-app
     template:
       metadata:
         labels:
           app: gke-cloud-sql-app
       spec:
         serviceAccountName: <YOUR-KSA-NAME>
         containers:
         - name: gke-cloud-sql-app
           # Replace <LOCATION> with your Artifact Registry location (e.g., us-central1).
           # Replace <YOUR_PROJECT_ID> with your project ID.
           image: <LOCATION>-docker.pkg.dev/<YOUR_PROJECT_ID>/gke-cloud-sql-repo/gke-sql:latest
           # This app listens on port 8080 for web traffic by default.
           ports:
           - containerPort: 8080
           env:
           - name: PORT
             value: "8080"
           # This project uses environment variables to determine
           # how you would like to run your application
           # To use the Python Connector (recommended) - use INSTANCE_CONNECTION_NAME (proj:region:instance)
           # To use TCP - Setting INSTANCE_HOST will use TCP (e.g., 127.0.0.1)
           # To use Unix, use INSTANCE_UNIX_SOCKET (e.g., /cloudsql/proj:region:instance)
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "3306"
           # For Automatic IAM Authentication with the Python Connector
           # use DB_IAM_USER instead of DB_USER (recommended)
           # You may also remove the DB_PASS environment variable if
           # you use Automatic IAM Authentication
           - name: DB_USER
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: username
           - name: DB_PASS
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: password
           - name: DB_NAME
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: database
         # If you are using the Python Connector (recommended), you can
         # remove cloud-sql-proxy (everything below this line)
         - name: cloud-sql-proxy
           # This uses the latest version of the Cloud SQL Proxy
           # It is recommended to use a specific version for production environments.
           # See: https://github.com/GoogleCloudPlatform/cloudsql-proxy 
           image: gcr.io/cloud-sql-connectors/cloud-sql-proxy:latest
           args:
             # If connecting from a VPC-native GKE cluster, you can use the
             # following flag to have the proxy connect over private IP
             # - "--private-ip"
   
             # If you are not connecting with Automatic IAM, you can delete
             # the following flag.
             - "--auto-iam-authn"
   
             # tcp should be set to the port the proxy should listen on
             # and should match the DB_PORT value set above.
             # Defaults: MySQL: 3306, Postgres: 5432, SQLServer: 1433
             - "--port=3306"
             - "<INSTANCE_CONNECTION_NAME>"
           securityContext:
             # The default Cloud SQL proxy image runs as the
             # "nonroot" user and group (uid: 65532) by default.
             runAsNonRoot: true
   

3. Execute o comando kubectl apply da seguinte maneira no Cloud Shell para implantar o aplicativo de amostra:

   kubectl apply -f deployment.yaml

4. Execute o comando kubectl apply da seguinte maneira para adicionar um balanceador de carga na frente da implantação, para que você possa acessá-lo na Internet:

   kubectl apply -f service.yaml

5. Execute o comando kubectl get da seguinte maneira para ver os detalhes do serviço:

   kubectl get services

6. Copie o endereço IP externo assim que ele ficar disponível nos detalhes do serviço, o que pode levar alguns minutos.
7. Veja o aplicativo de amostra implantado. Abra uma janela do navegador e acesse o endereço IP externo do serviço.