Estabeleça ligação ao Cloud SQL para SQL Server a partir do Google Kubernetes Engine

Estabeleça ligação ao Cloud SQL para SQL Server a partir do Google Kubernetes Engine

MySQL   |  PostgreSQL   |  SQL Server

Esta página mostra como implementar uma app de exemplo no Google Kubernetes Engine (GKE) ligado a uma instância do SQL Server através da Google Cloud consola e de uma aplicação cliente. Normalmente, os recursos criados neste início rápido custam menos de um dólar (USD), assumindo que conclui os passos, incluindo a limpeza, atempadamente.

Antes de começar

Nota: O nome que usa para o seu projeto tem de ter entre 4 e 30 carateres. Quando escreve o nome, o formulário sugere um ID do projeto, que pode editar. O ID do projeto tem de ter entre 6 e 30 carateres, com uma letra minúscula como o primeiro caráter. Pode usar um traço, uma letra minúscula ou um dígito para os carateres restantes, mas o último caráter não pode ser um traço.

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Ative as APIs Google Cloud necessárias para executar uma app de exemplo do Cloud SQL no GKE.

   Consola

   Clique em Ativar APIs para ativar as APIs necessárias para este início rápido.

   Ative as APIs

   Isto ativa as seguintes APIs:

   • API Compute Engine
   • API Cloud SQL Admin
   • Google Kubernetes Engine API
   • API Artifact Registry
   • API Cloud Build

   gcloud

   Clique no botão seguinte para abrir o Cloud Shell, que oferece acesso à linha de comandos aos seus Google Cloud recursos diretamente a partir do navegador. Pode usar o Cloud Shell para executar os comandos gcloud apresentados ao longo deste início rápido.

   Abra o Cloud Shell

   Execute o comando gcloud services enable da seguinte forma através da Cloud Shell para ativar as APIs necessárias para este início rápido:

   gcloud services enable compute.googleapis.com sqladmin.googleapis.com \
        container.googleapis.com artifactregistry.googleapis.com cloudbuild.googleapis.com

   Este comando ativa as seguintes APIs:

   • API Compute Engine
   • API Cloud SQL Admin
   • API GKE
   • API Artifact Registry
   • API Cloud Build

Configure o Cloud SQL

Crie uma instância do Cloud SQL

IP público

Consola

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

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Clique em Criar instância.
3. Clique em SQL Server.
4. Introduza quickstart-instance para o ID da instância.
5. Introduza uma palavra-passe para o utilizador do SQL Server. Guarde esta palavra-passe para utilização futura.
6. Clique na opção Zona única para Escolher região e disponibilidade zonal.
7. Clique e expanda a secção Mostrar configurações.
8. No menu pendente Tipo de máquina, selecione Leve.

9. Clique em Criar instância e aguarde até a instância ser inicializada e iniciada.

gcloud

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

Antes de executar o comando gcloud sql instances create da seguinte forma, substitua DB_ROOT_PASSWORD pela palavra-passe do utilizador da base de dados.

Opcionalmente, modifique os valores dos seguintes parâmetros:

• --database_version: o tipo e a versão do motor da base de dados. Se não for especificado, é usada a predefinição da API. Consulte a documentação versões da base de dados do gcloud para ver as versões atualmente disponíveis.
• --cpu: o número de núcleos pretendido na máquina.
• --memory: valor numérico inteiro que indica a quantidade de memória pretendida na máquina. Deve ser indicado um valor de tamanho (por exemplo, 3072 MB ou 9 GB). Se não forem especificadas unidades, é assumido que são GB.
• --region: localização regional da instância (por exemplo, asia-east1, us-east1). Se não for especificado, é usado o valor predefinido us-central. 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=SQLSERVER_2019_STANDARD \
--cpu=1 \
--memory=4GB \
--region=us-central \
--root-password=DB_ROOT_PASSWORD

IP privado

Consola

Crie uma instância com um endereço IP privado e SSL ativado

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Clique em Criar instância.
3. Clique em SQL Server.
4. Introduza quickstart-instance para o ID da instância.
5. Introduza uma palavra-passe para o utilizador do SQL Server. Guarde esta palavra-passe para utilização futura.
6. Clique na opção Zona única para Escolher região e disponibilidade zonal.
7. Clique e expanda Mostrar opções de configuração.
8. Para Tipo de máquina, selecione Leve.
9. Em Ligações, selecione IP privado.
10. Selecione predefinição no menu pendente Rede.
11. Se vir uma caixa de diálogo a indicar Ligação de acesso a serviços privados necessária, clique no botão Configurar ligação.
• Na caixa de diálogo Ativar API Service Networking, clique no botão Ativar API.
• Na caixa de diálogo Atribua um intervalo de IPs, selecione Usar um intervalo de IPs atribuído automaticamente e clique em Continuar.
• Na caixa de diálogo Criar uma associação, clique em Criar associação.
12. Desmarque a caixa de verificação IP público para criar uma instância apenas com um IP privado.
13. Clique em Criar instância e, de seguida, aguarde que a instância seja inicializada e iniciada.
14. Clique em Ligações.
15. Na secção Segurança, selecione Permitir apenas ligações SSL para ativar as ligações SSL.
16. Na caixa de diálogo Permitir apenas ligações SSL, clique em Guardar e reiniciar e, de seguida, aguarde que a instância seja reiniciada.

gcloud

Crie uma instância com um endereço IP privado e SSL ativado

A criação de uma instância com um endereço IP privado requer apenas a configuração do acesso a serviços privados para ativar ligações de outros Google Cloud serviços, como o GKE.

1. Execute o comando gcloud compute addresses create para atribuir um intervalo de IP para uma ligação de acesso a serviços privados:

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 ligação de acesso a serviços privados:

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 forma, substitua DB_ROOT_PASSWORD pela palavra-passe do utilizador da base de dados.

Opcionalmente, modifique os valores dos seguintes parâmetros:

• --database_version: o tipo e a versão do motor da base de dados. Se não for especificado, é usada a predefinição da API. Consulte as versões da base de dados do gcloud para ver uma lista das versões atualmente disponíveis.
• --cpu: o número de núcleos na máquina.
• --memory: um número inteiro que indica a quantidade de memória a incluir na máquina. Pode indicar uma unidade de tamanho (por exemplo, 3072 MB ou 9 GB). Se não forem especificadas unidades, é assumido que são GB.
• --region: a localização regional da instância (por exemplo, asia-east1, us-east1). Se não for especificado, é usado o valor predefinido us-central1. 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 privado.

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

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

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

Crie uma base de dados

Consola

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Selecione quickstart-instance.
3. No menu de navegação SQL, selecione Bases de dados.
4. Clique em Criar base de dados.
1. No campo Nome da base de dados da caixa de diálogo Nova base de dados, introduza quickstart-db.
2. Clique em Criar.

gcloud

Execute o comando gcloud sql databases create para criar uma base de dados.

gcloud sql databases create quickstart-db --instance=quickstart-instance

Crie um cluster do GKE

Consola

1. Na Google Cloud consola, aceda à página Google Kubernetes Engine.

   Aceda ao Google Kubernetes Engine

2. Clique em Criar.
3. Clique em Configurar para o GKE Autopilot.
4. Para Nome, especifique o nome do cluster como gke-cloud-sql-quickstart.
5. Clique em Criar.

gcloud

Execute o comando gcloud container clusters create-auto para criar o cluster.

gcloud container clusters create-auto gke-cloud-sql-quickstart \
    --region us-central1

Clone uma app de exemplo do Cloud SQL no editor do Cloud Shell

Com uma instância do Cloud SQL, uma base de dados e um cluster do GKE, pode agora clonar e configurar uma aplicação de exemplo para estabelecer ligação à sua instância do Cloud SQL. Os restantes passos neste início rápido requerem a utilização das ferramentas de linha de comandos gcloud e kubectl. Ambas as ferramentas estão pré-instaladas no Cloud Shell.

Ir

1. No editor do Cloud Shell, abra o código fonte da app de exemplo.
   Abra o editor do Cloud Shell
2. Na caixa de diálogo Open in Cloud Shell, clique em Confirmar para transferir o código da app de exemplo e abrir o diretório da app de exemplo no editor do Cloud Shell.

Java

1. No editor do Cloud Shell, abra o código fonte da app de exemplo.
   Abra o editor do Cloud Shell
2. Na caixa de diálogo Open in Cloud Shell, clique em Confirmar para transferir o código da app de exemplo e abrir o diretório da app de exemplo no editor do Cloud Shell.

Node.js

1. No editor do Cloud Shell, abra o código fonte da app de exemplo.
   Abra o editor do Cloud Shell
2. Na caixa de diálogo Open in Cloud Shell, clique em Confirmar para transferir o código da app de exemplo e abrir o diretório da app de exemplo no editor do Cloud Shell.

Python

1. No editor do Cloud Shell, abra o código fonte da app de exemplo.
   Abra o editor do Cloud Shell
2. Na caixa de diálogo Open in Cloud Shell, clique em Confirmar para transferir o código da app de exemplo e abrir o diretório da app de exemplo no editor do Cloud Shell.

Ative o cluster do GKE

Ative o cluster do GKE que acabou de criar como o cluster predefinido a usar para os restantes comandos neste início rápido.

Execute o comando gcloud container clusters get-credentials da seguinte forma para ativar o cluster do GKE.

gcloud container clusters get-credentials gke-cloud-sql-quickstart \
  --region us-central1

Configure uma conta de serviço

Crie e configure uma Google Cloud conta de serviço a ser usada pelo GKE para que tenha a função cliente do Cloud SQL com autorizações para se ligar ao Cloud SQL.

1. Execute o comando gcloud iam service-accounts create da seguinte forma para criar uma nova conta de serviço:

   gcloud iam service-accounts create gke-quickstart-service-account \
     --display-name="GKE Quickstart Service Account"

2. Execute o comando gcloud projects add-iam-policy-binding da seguinte forma para adicionar a função cliente do Cloud SQL à Google Cloud conta de serviço que acabou de criar. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
     --role="roles/cloudsql.client"

3. A app de exemplo usa o registo, por isso, execute o comando gcloud projects add-iam-policy-binding da seguinte forma para adicionar a função Log Writer à Google Cloud conta de serviço que acabou de criar. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
     --role="roles/logging.logWriter"

4. A conta de serviço tem de conseguir obter imagens do repositório do artifactory. Por isso, execute o comando
   gcloud projects add-iam-policy-binding da seguinte forma para adicionar a função Leitor do Artifact Registry à conta de serviço. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
     --role="roles/artifactregistry.reader"

Crie uma conta de serviço do Kubernetes configurada para ter acesso ao Cloud SQL associando-a à Google Cloud conta de serviço através da federação de identidades da carga de trabalho para o GKE.

1. Crie uma conta de serviço do Kubernetes.
   1. Atualize o ficheiro service-account.yaml no editor do Cloud Shell. Substituir <YOUR-KSA-NAME> por ksa-cloud-sql.
   2. Execute o comando kubectl apply da seguinte forma no Cloud Shell:

      kubectl apply -f service-account.yaml

2. Execute o comando gcloud iam service-accounts add-iam-policy-binding da seguinte forma para ativar a associação do IAM da Google Cloud conta de serviço e da conta de serviço do Kubernetes. Faça as seguintes substituições:
   • YOUR_PROJECT_ID com o ID do projeto.
   • YOUR_K8S_NAMESPACE com default, que é o espaço de nomes predefinido para clusters criados no GKE.
   • YOUR_KSA_NAME com ksa-cloud-sql.

   gcloud iam service-accounts add-iam-policy-binding \
     --role="roles/iam.workloadIdentityUser" \
     --member="serviceAccount:YOUR_PROJECT_ID.svc.id.goog[YOUR_K8S_NAMESPACE/YOUR_KSA_NAME]" \
     gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com

3. Execute o comando kubectl annotate da seguinte forma para anotar a conta de serviço do Kubernetes com a vinculação de IAM. Faça as seguintes substituições:
   • YOUR_KSA_NAME com ksa-cloud-sql.
   • YOUR_PROJECT_ID com o ID do projeto.

   kubectl annotate serviceaccount \
     YOUR_KSA_NAME  \
     iam.gke.io/gcp-service-account=gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com

Configure segredos

Execute o comando kubectl create secret generic da seguinte forma para criar segredos do Kubernetes para a base de dados, o utilizador e a palavra-passe do utilizador a serem usados pela app de exemplo. Os valores de cada segredo baseiam-se nos valores especificados nos passos anteriores deste início rápido. Substitua DB_PASS pela palavra-passe do sqlserver utilizador root que foi criada no passo Crie uma instância do Cloud SQL.

kubectl create secret generic gke-cloud-sql-secrets \
  --from-literal=database=quickstart-db \
  --from-literal=username=sqlserver \
  --from-literal=password=DB_PASS

Crie a app de exemplo

Ir

1. Execute o seguinte comando gcloud artifacts repositories create no Cloud Shell para criar um repositório no Artifact Registry denominado gke-cloud-sql-repo na mesma região que o cluster. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud artifacts repositories create gke-cloud-sql-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=us-central1 \
     --description="GKE Quickstart sample app"

2. Execute o comando gcloud builds submit da seguinte forma no Cloud Shell para criar um contentor Docker e publicá-lo no Artifact Registry. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud builds submit \
     --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/gke-cloud-sql-repo/gke-sql .

Java

1. Execute o seguinte comando gcloud artifacts repositories create no Cloud Shell para criar um repositório no Artifact Registry denominado gke-cloud-sql-repo na mesma região que o cluster. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud artifacts repositories create gke-cloud-sql-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=us-central1 \
     --description="GKE Quickstart sample app"

2. Execute o comando mvn da seguinte forma no Cloud Shell para criar um contentor Docker e publicá-lo no Artifact Registry. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
     -Dimage=us-central1-docker.pkg.dev/YOUR_PROJECT_ID/gke-cloud-sql-repo/gke-sql \
     -DskipTests -Djib.to.credHelper=gcloud

Node.js

1. Execute o seguinte comando gcloud artifacts repositories create no Cloud Shell para criar um repositório no Artifact Registry denominado gke-cloud-sql-repo na mesma região que o cluster. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud artifacts repositories create gke-cloud-sql-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=us-central1 \
     --description="GKE Quickstart sample app"

2. Execute o comando gcloud builds submit da seguinte forma no Cloud Shell para criar um contentor Docker e publicá-lo no Artifact Registry. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud builds submit \
     --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/gke-cloud-sql-repo/gke-sql .

Python

1. Execute o seguinte comando gcloud artifacts repositories create no Cloud Shell para criar um repositório no Artifact Registry denominado gke-cloud-sql-repo na mesma região que o cluster. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud artifacts repositories create gke-cloud-sql-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=us-central1 \
     --description="GKE Quickstart sample app"

2. Execute o comando gcloud builds submit da seguinte forma no Cloud Shell para criar um contentor Docker e publicá-lo no Artifact Registry. Substitua YOUR_PROJECT_ID pelo ID do projeto.

   gcloud builds submit \
     --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/gke-cloud-sql-repo/gke-sql .

Implemente a app de exemplo

IP público

Com a configuração da app de exemplo implementada, já pode implementar a app de exemplo.

Ir

A app de exemplo implementada liga-se à sua instância do Cloud SQL através do proxy do Cloud SQL executado num padrão de sidecar do Kubernetes. O padrão de sidecar é alcançado implementando uma carga de trabalho com um contentor adicional que partilha o mesmo pod do Kubernetes que o contentor da app de exemplo.

1. Obtenha o nome de ligação da instância do Cloud SQL executando o comando gcloud sql instances describe:

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

2. Atualize o ficheiro 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> com o ID do projeto.
   • <YOUR-DB-SECRET> com gke-cloud-sql-secrets.
   • <INSTANCE_CONNECTION_NAME> com o nome de ligação da instância do Cloud SQL obtido a partir do comando gcloud no passo anterior. O formato é project_id:region:instance_name. O nome de ligação da instância também está visível na página Vista 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:
         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: "1433"
           - 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"
   
             # 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=1433"
             - "<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 forma no Cloud Shell para implementar a app de exemplo:

   kubectl apply -f deployment.yaml

4. Execute o comando kubectl apply da seguinte forma para adicionar um equilibrador de carga à frente da implementação, para que possa aceder à mesma através da Internet:

   kubectl apply -f service.yaml

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

   kubectl get services

6. Copie o endereço de IP externo assim que estiver disponível nos detalhes do serviço, o que pode demorar alguns minutos.
7. Veja a app de exemplo implementada. Abra uma janela do navegador e aceda ao endereço IP externo do serviço.

   

Java

A app de exemplo implementada liga-se à sua instância do Cloud SQL através do conetor Java do Cloud SQL.

1. Obtenha o nome de ligação da instância do Cloud SQL executando o comando gcloud sql instances describe:

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

2. Atualize o ficheiro 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> com o ID do projeto.
   • <YOUR-DB-SECRET> com gke-cloud-sql-secrets.
   • <INSTANCE_CONNECTION_NAME> com o nome de ligação da instância do Cloud SQL obtido a partir do comando gcloud no passo anterior. O formato é project_id:region:instance_name. O nome de ligação da instância também está visível na página Vista 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: "1433"  
           - 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 forma no Cloud Shell para implementar a app de exemplo:

   kubectl apply -f deployment.yaml

4. Execute o comando kubectl apply da seguinte forma para adicionar um equilibrador de carga à frente da implementação, para que possa aceder à mesma através da Internet:

   kubectl apply -f service.yaml

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

   kubectl get services

6. Copie o endereço de IP externo assim que estiver disponível nos detalhes do serviço, o que pode demorar alguns minutos.
7. Veja a app de exemplo implementada. Abra uma janela do navegador e aceda ao endereço IP externo do serviço.

   

Node.js

A app de exemplo implementada liga-se à sua instância do Cloud SQL através do proxy do Cloud SQL executado num padrão de sidecar do Kubernetes. O padrão de sidecar é alcançado implementando uma carga de trabalho com um contentor adicional que partilha o mesmo pod do Kubernetes que o contentor da app de exemplo.

1. Obtenha o nome de ligação da instância do Cloud SQL executando o comando gcloud sql instances describe:

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

2. Atualize o ficheiro 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> com o ID do projeto.
   • <YOUR-DB-SECRET> com gke-cloud-sql-secrets.
   • <INSTANCE_CONNECTION_NAME> com o nome de ligação da instância do Cloud SQL obtido a partir do comando gcloud no passo anterior. O formato é project_id:region:instance_name. O nome de ligação da instância também está visível na página Vista 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:
         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: "1433"  
           - 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"
   
             # 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=1433"
             - "<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 forma no Cloud Shell para implementar a app de exemplo:

   kubectl apply -f deployment.yaml

4. Execute o comando kubectl apply da seguinte forma para adicionar um equilibrador de carga à frente da implementação, para que possa aceder à mesma através da Internet:

   kubectl apply -f service.yaml

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

   kubectl get services

6. Copie o endereço de IP externo assim que estiver disponível nos detalhes do serviço, o que pode demorar alguns minutos.
7. Veja a app de exemplo implementada. Abra uma janela do navegador e aceda ao endereço IP externo do serviço.

   

Python

A app de exemplo implementada liga-se à sua instância do Cloud SQL através do proxy do Cloud SQL executado num padrão de sidecar do Kubernetes. O padrão de sidecar é alcançado implementando uma carga de trabalho com um contentor adicional que partilha o mesmo pod do Kubernetes que o contentor da app de exemplo.

1. Obtenha o nome de ligação da instância do Cloud SQL executando o comando gcloud sql instances describe:

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

2. Atualize o ficheiro 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> com o ID do projeto.
   • <YOUR-DB-SECRET> com gke-cloud-sql-secrets.
   • <INSTANCE_CONNECTION_NAME> com o nome de ligação da instância do Cloud SQL obtido a partir do comando gcloud no passo anterior. O formato é project_id:region:instance_name. O nome de ligação da instância também está visível na página Vista 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:
         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)
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "1433"
           # If connecting from a VPC-native GKE cluster, you can use the
           # following environment variable to have the proxy connect over private IP
           # - name: CLOUD_SQL_AUTH_PROXY_IP_ADDRESS_TYPE
           #   value: "PRIVATE"
           - 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"
   
             # 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=1433"
             - "<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 forma no Cloud Shell para implementar a app de exemplo:

   kubectl apply -f deployment.yaml

4. Execute o comando kubectl apply da seguinte forma para adicionar um equilibrador de carga à frente da implementação, para que possa aceder à mesma através da Internet:

   kubectl apply -f service.yaml

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

   kubectl get services

6. Copie o endereço de IP externo assim que estiver disponível nos detalhes do serviço, o que pode demorar alguns minutos.
7. Veja a app de exemplo implementada. Abra uma janela do navegador e aceda ao endereço IP externo do serviço.

   

IP privado

Com a configuração da app de exemplo implementada, já pode implementar a app de exemplo.

Ir

A app de exemplo implementada liga-se à sua instância do Cloud SQL através do proxy do Cloud SQL executado num padrão de sidecar do Kubernetes. O padrão de sidecar é alcançado implementando uma carga de trabalho com um contentor adicional que partilha o mesmo pod do Kubernetes que o contentor da app de exemplo.

1. Obtenha o nome de ligação da instância do Cloud SQL executando o comando gcloud sql instances describe:

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

2. Atualize o ficheiro deployment.yaml no editor do Cloud Shell. Faça as seguintes substituições e edições:
   • Substituir <YOUR_KSA_NAME> por ksa-cloud-sql.
   • Substituir <LOCATION> por us-central1.
   • Substitua <YOUR_PROJECT_ID> pelo ID do projeto.
   • Substituir <YOUR-DB-SECRET> por gke-cloud-sql-secrets.
   • Substitua <INSTANCE_CONNECTION_NAME> pelo nome de ligação da instância do Cloud SQL obtido a partir do comando gcloud no passo anterior. O formato é project_id:region:instance_name. O nome de ligação da instância também está visível na página Vista geral da instância do Cloud SQL.
   • Ative o proxy Auth do Cloud SQL para estabelecer ligação à sua instância do Cloud SQL através do respetivo endereço IP privado. Descomente a flag "-ip_address_types=PRIVATE" removendo o símbolo de comentário # e o espaço em branco à direita. A flag sem comentário deve ter o seguinte aspeto:

     - "-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: "1433"
           - 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"
   
             # 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=1433"
             - "<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 forma no Cloud Shell para implementar a app de exemplo:

   kubectl apply -f deployment.yaml

4. Execute o comando kubectl apply da seguinte forma para adicionar um equilibrador de carga à frente da implementação, para que possa aceder à mesma através da Internet:

   kubectl apply -f service.yaml

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

   kubectl get services

6. Copie o endereço de IP externo assim que estiver disponível nos detalhes do serviço, o que pode demorar alguns minutos.
7. Veja a app de exemplo implementada. Abra uma janela do navegador e aceda ao endereço IP externo do serviço.

   

Java

A app de exemplo implementada liga-se à sua instância do Cloud SQL através do conetor Java do Cloud SQL.

1. Obtenha o nome de ligação da instância do Cloud SQL executando o comando gcloud sql instances describe:

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

2. Atualize o ficheiro 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> com o ID do projeto.
   • <YOUR-DB-SECRET> com gke-cloud-sql-secrets.
   • <INSTANCE_CONNECTION_NAME> com o nome de ligação da instância do Cloud SQL obtido a partir do comando gcloud no passo anterior. O formato é project_id:region:instance_name. O nome de ligação da instância também está visível na página Vista 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: "1433"  
           - 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 forma no Cloud Shell para implementar a app de exemplo:

   kubectl apply -f deployment.yaml

4. Execute o comando kubectl apply da seguinte forma para adicionar um equilibrador de carga à frente da implementação, para que possa aceder à mesma através da Internet:

   kubectl apply -f service.yaml

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

   kubectl get services

6. Copie o endereço de IP externo assim que estiver disponível nos detalhes do serviço, o que pode demorar alguns minutos.
7. Veja a app de exemplo implementada. Abra uma janela do navegador e aceda ao endereço IP externo do serviço.

   

Node.js

A app de exemplo implementada liga-se à sua instância do Cloud SQL através do proxy do Cloud SQL executado num padrão de sidecar do Kubernetes. O padrão de sidecar é alcançado implementando uma carga de trabalho com um contentor adicional que partilha o mesmo pod do Kubernetes que o contentor da app de exemplo.

1. Obtenha o nome de ligação da instância do Cloud SQL executando o comando gcloud sql instances describe:

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

2. Atualize o ficheiro deployment.yaml no editor do Cloud Shell. Faça as seguintes substituições e edições:
   • Substituir <YOUR_KSA_NAME> por ksa-cloud-sql.
   • Substituir <LOCATION> por us-central1.
   • Substitua <YOUR_PROJECT_ID> pelo ID do projeto.
   • Substituir <YOUR-DB-SECRET> por gke-cloud-sql-secrets.
   • Substitua <INSTANCE_CONNECTION_NAME> pelo nome de ligação da instância do Cloud SQL obtido a partir do comando gcloud no passo anterior. O formato é project_id:region:instance_name. O nome de ligação da instância também está visível na página Vista geral da instância do Cloud SQL.
   • Ative o proxy Auth do Cloud SQL para estabelecer ligação à sua instância do Cloud SQL através do respetivo endereço IP privado. Descomente a flag "-ip_address_types=PRIVATE" removendo o símbolo de comentário # e o espaço em branco à direita. A flag sem comentário deve ter o seguinte aspeto:

     - "-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: "1433"  
           - 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"
   
             # 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=1433"
             - "<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 forma no Cloud Shell para implementar a app de exemplo:

   kubectl apply -f deployment.yaml

4. Execute o comando kubectl apply da seguinte forma para adicionar um equilibrador de carga à frente da implementação, para que possa aceder à mesma através da Internet:

   kubectl apply -f service.yaml

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

   kubectl get services

6. Copie o endereço de IP externo assim que estiver disponível nos detalhes do serviço, o que pode demorar alguns minutos.
7. Veja a app de exemplo implementada. Abra uma janela do navegador e aceda ao endereço IP externo do serviço.

   

Python

A app de exemplo implementada liga-se à sua instância do Cloud SQL através do proxy do Cloud SQL executado num padrão de sidecar do Kubernetes. O padrão de sidecar é alcançado implementando uma carga de trabalho com um contentor adicional que partilha o mesmo pod do Kubernetes que o contentor da app de exemplo.

1. Obtenha o nome de ligação da instância do Cloud SQL executando o comando gcloud sql instances describe:

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

2. Atualize o ficheiro deployment.yaml no editor do Cloud Shell. Faça as seguintes substituições e edições:
   • Substituir <YOUR_KSA_NAME> por ksa-cloud-sql.
   • Substituir <LOCATION> por us-central1.
   • Substitua <YOUR_PROJECT_ID> pelo ID do projeto.
   • Substituir <YOUR-DB-SECRET> por gke-cloud-sql-secrets.
   • Substitua <INSTANCE_CONNECTION_NAME> pelo nome de ligação da instância do Cloud SQL obtido a partir do comando gcloud no passo anterior. O formato é project_id:region:instance_name. O nome de ligação da instância também está visível na página Vista geral da instância do Cloud SQL.
   • Ative o proxy Auth do Cloud SQL para estabelecer ligação à sua instância do Cloud SQL através do respetivo endereço IP privado. Descomente a flag "-ip_address_types=PRIVATE" removendo o símbolo de comentário # e o espaço em branco à direita. A flag sem comentário deve ter o seguinte aspeto:

     - "-ip_address_types=PRIVATE"

   • Descomente a variável de ambiente - name: CLOUD_SQL_AUTH_PROXY_IP_ADDRESS_TYPE e o respetivo valor removendo os símbolos de comentário # e o espaço em branco à direita. A variável de ambiente e o valor sem comentário devem ter o seguinte aspeto:

      - name: CLOUD_SQL_AUTH_PROXY_IP_ADDRESS_TYPE
        value: "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)
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "1433"
           # If connecting from a VPC-native GKE cluster, you can use the
           # following environment variable to have the proxy connect over private IP
           # - name: CLOUD_SQL_AUTH_PROXY_IP_ADDRESS_TYPE
           #   value: "PRIVATE"
           - 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"
   
             # 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=1433"
             - "<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 forma no Cloud Shell para implementar a app de exemplo:

   kubectl apply -f deployment.yaml

4. Execute o comando kubectl apply da seguinte forma para adicionar um equilibrador de carga à frente da implementação, para que possa aceder à mesma através da Internet:

   kubectl apply -f service.yaml

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

   kubectl get services

6. Copie o endereço de IP externo assim que estiver disponível nos detalhes do serviço, o que pode demorar alguns minutos.
7. Veja a app de exemplo implementada. Abra uma janela do navegador e aceda ao endereço IP externo do serviço.

   

Limpar

Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Selecione a instância quickstart-instance para abrir a página Detalhes da instância.
3. Na barra de ícones na parte superior da página, clique em Eliminar.
4. Na caixa de diálogo Eliminar instância, escreva quickstart-instance e, de seguida, clique em Eliminar para eliminar a instância.

5. Na Google Cloud consola, aceda à página Google Kubernetes Engine.

   Aceda ao Google Kubernetes Engine

6. Clique na caixa de verificação junto ao nome do serviço gke-cloud-sql-quickstart.
7. Clique no botão Eliminar na parte superior da página do Google Kubernetes Engine.

Passos de limpeza opcionais

Se não estiver a usar a Google Cloud conta de serviço que criou para este início rápido, pode removê-la.

1. Na Google Cloud consola, aceda à página IAM.

   Aceda ao IAM

2. Selecione a caixa de verificação da conta do IAM com o nome gke-quickstart-service-account.
3. Clique em Remover e confirme a remoção.

Se não estiver a usar as APIs que foram ativadas como parte deste início rápido, pode desativá-las.

• APIs ativadas neste guia de início rápido:
  • API Compute Engine
  • API Cloud SQL Admin
  • Google Kubernetes Engine API
  • API Artifact Registry
  • API Cloud Build

1. Na Google Cloud consola, aceda à página APIs.

   Aceder às APIs

2. Selecione qualquer API que queira desativar e, de seguida, clique no botão Desativar API.

O que se segue?

Com base nas suas necessidades, pode saber mais sobre como criar instâncias do Cloud SQL.

Também pode saber como criar utilizadores do SQL Server e bases de dados para a sua instância do Cloud SQL.

Consulte também as informações de preços do Cloud SQL.

Saiba mais sobre:

• Todas as opções de conectividade no Cloud SQL.
• Configurar a instância do Cloud SQL com um endereço IP público.
• Configurar a sua instância do Cloud SQL com um endereço IP privado.

Além disso, pode saber como estabelecer ligação a uma instância do Cloud SQL a partir de outras aplicações do Google Cloud:

• A partir de uma aplicação em execução no ambiente padrão do App Engine
• A partir de uma aplicação em execução no Compute Engine
• A partir de uma aplicação executada no GKE
• Do Cloud Run