Instâncias de clone, Instâncias de clone, Instâncias de clone, Instâncias de clone

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Console

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

   Acesse Instâncias do Cloud SQL

2. Localize a linha da instância a ser clonada.
3. Na coluna Ações , clique no menu more_vert Mais ações .
4. Clique em Criar clone .
5. Na página Criar um clone , atualize o ID da instância, se necessário, e clique em Criar clone , deixando Clonar estado atual da instância selecionado.

   Você retornará à página de listagem de instâncias enquanto o clone é inicializado.

gcloud

Para clonar uma instância, use o comando gcloud sql instances clone :

gcloud sql instances clone SOURCE_INSTANCE_NAME DESTINATION_INSTANCE_NAME \
--project PROJECT_ID \
--preferred-zone ZONE_NAME \
--preferred-secondary-zone SECONDARY_ZONE_NAME

Faça as seguintes substituições:

• SOURCE_INSTANCE_NAME : o nome da instância do Cloud SQL a ser clonada.
• DESTINATION_INSTANCE_NAME : o nome da instância clonada.
• PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém as instâncias de origem e destino.
• ZONE_NAME : Opcional. O nome da zona primária da instância de destino. Use-o se desejar que a instância de destino esteja em uma zona primária diferente da instância do Cloud SQL que você está clonando. Para uma instância regional, essa zona substitui a zona primária, mas a zona secundária permanece a mesma da instância de origem.
• SECONDARY_ZONE_NAME : Opcional. O nome da zona secundária para a instância de destino. Use esta opção para especificar uma zona secundária diferente para a instância regional do Cloud SQL que você deseja clonar.

Se você estiver usando os parâmetros --preferred-zone e --preferred-secondary-zone , as seguintes condições se aplicarão:

• Tanto a zona primária quanto a secundária devem ser zonas válidas.
• Ambas as zonas devem pertencer à mesma região que a instância de origem.
• As zonas primária e secundária devem ser diferentes.
• Para instâncias zonais, não é possível usar o parâmetro --preferred-secondary-zone . Se o fizer, o processo de clonagem da instância falhará.
• Se você não especificar valores para os parâmetros --preferred-zone ou --preferred-secondary-zone , a instância clonada terá as mesmas zonas primária e secundária que a instância de origem.

Para executar o comando gcloud sql instances clone , você precisa ter a permissão cloudsql.instances.clone . Para obter mais informações sobre as permissões necessárias para executar comandos da CLI do gcloud , consulte Permissões do Cloud SQL .

Terraform

Para clonar a instância, use um recurso do Terraform

resource "google_sql_database_instance" "clone" {
  name             = "mysql-instance-clone-name"
  region           = "us-central1"
  database_version = "MYSQL_8_0"
  clone {
    source_instance_name = google_sql_database_instance.source.id
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Aplicar as alterações

Para aplicar sua configuração do Terraform em um Google Cloud projeto, conclua as etapas nas seções a seguir.

Preparar o Cloud Shell

1. Inicie o Cloud Shell .

2. Defina o padrão Google Cloud projeto onde você deseja aplicar suas configurações do Terraform.

   Você só precisa executar este comando uma vez por projeto e pode executá-lo em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Variáveis ​​de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.

Preparar o diretório

Cada arquivo de configuração do Terraform deve ter seu próprio diretório (também chamado de módulo raiz ).

1. No Cloud Shell , crie um diretório e um novo arquivo dentro dele. O nome do arquivo deve ter a extensão .tf — por exemplo, main.tf Neste tutorial, o arquivo será chamado de main.tf

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se estiver seguindo um tutorial, você pode copiar o código de exemplo em cada seção ou etapa.

   Copie o código de exemplo no main.tf recém-criado.

   Opcionalmente, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução completa.

3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
4. Salve suas alterações.
5. Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.

   terraform init

   Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção -upgrade :

   terraform init -upgrade

Aplicar as alterações

1. Revise a configuração e verifique se os recursos que o Terraform irá criar ou atualizar correspondem às suas expectativas:

   terraform plan

   Faça correções na configuração conforme necessário.

2. Aplique a configuração do Terraform executando o seguinte comando e digitando yes no prompt:

   terraform apply

   Aguarde até que o Terraform exiba a mensagem "Aplicação concluída!".

3. Abra seu Google Cloud projeto para visualizar os resultados. No Google Cloud console, navegue até seus recursos na interface do usuário para garantir que o Terraform os criou ou atualizou.

Excluir as alterações

Para excluir suas alterações, faça o seguinte:

1. Para desabilitar a proteção contra exclusão, no seu arquivo de configuração do Terraform defina o argumento deletion_protection como false .

   deletion_protection =  "false"

2. Aplique a configuração atualizada do Terraform executando o seguinte comando e digitando yes no prompt:

   terraform apply

3. Remova os recursos aplicados anteriormente com sua configuração do Terraform executando o seguinte comando e digitando yes no prompt:

   terraform destroy

REST v1

Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:

• PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém as instâncias de origem e destino.
• SOURCE_INSTANCE_NAME : o nome da instância do Cloud SQL a ser clonada.
• DESTINATION_INSTANCE_NAME : o nome da instância clonada.
• ZONE_NAME : Opcional. O nome da zona primária da instância de destino. Use-o se desejar que a instância de destino esteja em uma zona primária diferente da instância do Cloud SQL que você está clonando. Para uma instância regional, essa zona substitui a zona primária, mas a zona secundária permanece a mesma da instância de origem.
• SECONDARY_ZONE_NAME : Opcional. O nome da zona secundária para a instância de destino. Use esta opção para especificar uma zona secundária diferente para a instância regional do Cloud SQL que você deseja clonar.

Método HTTP e URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone

Corpo JSON da solicitação:

{
  "cloneContext":
  {
    "destinationInstanceName": "DESTINATION_INSTANCE_NAME",
    "preferredZone": "ZONE_NAME",
    "preferredSecondaryZone": "SECONDARY_ZONE_NAME"
  }
}

Para enviar sua solicitação, expanda uma destas opções:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone" | Select-Object -Expand Content

Você deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "DESTINATION_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Se você estiver usando os parâmetros preferredZone e preferredSecondaryZone , as seguintes condições se aplicarão:

• Tanto a zona primária quanto a secundária devem ser zonas válidas.
• Ambas as zonas devem pertencer à mesma região que a instância de origem.
• As zonas primária e secundária devem ser diferentes.
• Para instâncias zonais, não é possível usar o parâmetro preferredSecondaryZone . Se o fizer, o processo de clonagem da instância falhará.
• Se você não especificar valores para os parâmetros preferredZone ou preferredSecondaryZone , a instância clonada terá as mesmas zonas primária e secundária que a instância de origem.

Para usar o método de API instances.clone , você precisa ter a permissão cloudsql.instances.clone . Para obter mais informações sobre as permissões necessárias para usar métodos de API, consulte Permissões do Cloud SQL .

REST v1beta4

Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:

• PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém as instâncias de origem e destino.
• SOURCE_INSTANCE_NAME : o nome da instância do Cloud SQL a ser clonada.
• DESTINATION_INSTANCE_NAME : o nome da instância clonada.
• ZONE_NAME : Opcional. O nome da zona primária da instância de destino. Use-o se desejar que a instância de destino esteja em uma zona primária diferente da instância do Cloud SQL que você está clonando. Para uma instância regional, essa zona substitui a zona primária, mas a zona secundária permanece a mesma da instância de origem.
• SECONDARY_ZONE_NAME : Opcional. O nome da zona secundária para a instância de destino. Use esta opção para especificar uma zona secundária diferente para a instância regional do Cloud SQL que você deseja clonar.

Método HTTP e URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone

Corpo JSON da solicitação:

{
  "cloneContext":
  {
    "destinationInstanceName": "DESTINATION_INSTANCE_NAME",
    "preferredZone": "ZONE_NAME",
    "preferredSecondaryZone": "SECONDARY_ZONE_NAME"
  }
}

Para enviar sua solicitação, expanda uma destas opções:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/SOURCE_INSTANCE_NAME/clone" | Select-Object -Expand Content

Você deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "OPERATION_ID",
  "targetId": "DESTINATION_INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Se você estiver usando os parâmetros preferredZone e preferredSecondaryZone , as seguintes condições se aplicarão:

• Tanto a zona primária quanto a secundária devem ser zonas válidas.
• Ambas as zonas devem pertencer à mesma região que a instância de origem.
• As zonas primária e secundária devem ser diferentes.
• Para instâncias zonais, não é possível usar o parâmetro preferredSecondaryZone . Se o fizer, o processo de clonagem da instância falhará.
• Se você não especificar valores para os parâmetros preferredZone ou preferredSecondaryZone , a instância clonada terá as mesmas zonas primária e secundária que a instância de origem.

Para usar o método de API instances.clone , você precisa ter a permissão cloudsql.instances.clone . Para obter mais informações sobre as permissões necessárias para usar métodos de API, consulte Permissões do Cloud SQL .

gcloud

Clone a instância, opcionalmente especificando o intervalo de IP alocado que você deseja usar:

gcloud sql instances clone SOURCE_INSTANCE_NAME TARGET_INSTANCE_NAME \
--allocated-ip-range-name ALLOCATED_IP_RANGE_NAME

A conta de usuário ou serviço que executa o comando gcloud sql instances clone precisa ter a permissão cloudsql.instances.clone . Para obter mais informações sobre as permissões necessárias para executar comandos da CLI do gcloud , consulte Permissões do Cloud SQL .

REST v1

Clone a instância, opcionalmente especificando o intervalo de IP alocado que você deseja usar:

Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:

• project-id : o ID do projeto
• source-instance-id : o ID da instância de origem
• target-instance-id : o ID da instância de destino
• allocated-ip-range-name : o nome de um intervalo de IP alocado

Método HTTP e URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone

Corpo JSON da solicitação:

{
  "cloneContext":
  {
    "destinationInstanceName": "target-instance-id",
    "allocatedIpRange": "allocated-ip-range-name"
  }
}

Para enviar sua solicitação, expanda uma destas opções:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

Você deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

A conta de usuário ou serviço que utiliza o método de API instances.clone deve ter a permissão cloudsql.instances.clone . Para obter mais informações sobre as permissões necessárias para usar métodos de API, consulte Permissões do Cloud SQL .

REST v1beta4

Clone a instância, opcionalmente especificando o intervalo de IP alocado que você deseja usar:

Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:

• project-id : o ID do projeto
• source-instance-id : o ID da instância de origem
• target-instance-id : o ID da instância de destino
• allocated-ip-range-name : o nome de um intervalo de IP alocado

Método HTTP e URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone

Corpo JSON da solicitação:

{
  "cloneContext":
  {
    "destinationInstanceName": "target-instance-id",
    "allocatedIpRange": "allocated-ip-range-name"
  }
}

Para enviar sua solicitação, expanda uma destas opções:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/source-instance-id/clone" | Select-Object -Expand Content

Você deve receber uma resposta JSON semelhante à seguinte:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CLONE",
  "name": "operation-id",
  "targetId": "target-instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

A conta de usuário ou serviço que utiliza o método de API instances.clone deve ter a permissão cloudsql.instances.clone . Para obter mais informações sobre as permissões necessárias para usar métodos de API, consulte Permissões do Cloud SQL .