Criar uma instância de teste gratuito e um aplicativo de exemplo do Spanner

Observação: uma instância de teste gratuito do Spanner oferece suporte a recursos da edição Standard e da edição Enterprise, como funções de distância de vetor KNN, pesquisa de texto completo e Spanner Graph. Para mais informações, consulte a Visão geral das edições do Spanner.

Neste guia de início rápido, mostramos como usar uma instância de teste gratuita do Spanner e um aplicativo de exemplo. Para mais informações, consulte a visão geral das instâncias de teste sem custo financeiro do Spanner.

Comece com uma instância de teste gratuito

Uma instância de teste gratuito de 90 dias do Spanner está disponível para qualquer pessoa com uma Conta do Google que tenha o faturamento do Cloud ativado no projeto. Você não vai receber cobranças a menos que escolha fazer upgrade da instância de teste gratuito para uma paga.

É possível criar uma instância de teste gratuita usando o console do Google Cloud ou a CLI do Google Cloud.

Observação: só é possível criar uma instância de teste gratuito por ciclo de vida do projeto e, no máximo, cinco instâncias de teste gratuito por conta do Cloud Billing.

Criar uma instância de teste gratuito usando o console do Google Cloud

As etapas a seguir explicam como criar uma instância de teste gratuita usando o console do Google Cloud.

Antes de começar

1. No Console do Google Cloud, acesse a página Spanner.

   Acessar o Spanner

2. Selecione ou crie um projeto do Google Cloud, caso ainda não tenha feito isso.

3. Na página Spanner, clique em Iniciar teste sem custos.

   

4. Se o Cloud Billing já estiver ativado para seu projeto, pule para Criar uma instância de teste gratuito na próxima seção.

   Se o Faturamento do Cloud não estiver ativado para seu projeto, vincule uma conta existente ou crie uma nova. O Google usa essas informações de pagamento para verificar sua identidade. Não cobramos sua instância do Spanner, a menos que você faça upgrade da sua conta do Cloud Billing para uma conta paga e faça upgrade da sua instância de teste gratuito do Spanner para uma conta paga.

   a. Clique em Acessar faturamento.

   

   b. Em seguida, clique em Vincular uma conta de faturamento.

   

   Observação: se você é um cliente Google Cloud novo, talvez também se qualifique para o Google Cloud teste gratuito de 90 dias e US$ 300, que oferece US $300 em créditos gratuitos do Cloud Billing para pagar por qualquer Google Cloudrecurso. A instância de teste gratuito do Spanner é um complemento dos créditos de US $300 oferecidos pelo Google Cloud Teste gratuito, e você não precisa usar créditos gratuitos do Cloud Billing para criar uma instância de teste gratuito.

   c. Siga as etapas para criar uma conta de faturamento e vinculá-la ao seu projeto.

   d. Depois de ativar o Faturamento do Cloud para seu projeto, acesse a página Spanner.

   Acessar o Spanner

   e. Clique em Iniciar teste sem custos e prossiga para Criar instância de teste sem custos na próxima seção.

5. Opcional: se você já criou uma instância do Spanner no projeto, a página Instâncias do Spanner será exibida.

   Clique em Iniciar teste sem custos.

   

Criar uma instância de teste gratuito

Na página Criar sua instância de teste gratuito, siga estas etapas:

1. No campo Nome da instância, insira um nome de instância, como Trial instance.

2. O ID da instância é preenchido automaticamente com base no nome da instância, por exemplo, trial-instance. Mude-a, se necessário.

3. Na seção Escolher uma configuração, selecione uma configuração no menu suspenso.

   A configuração da instância determina a localização geográfica em que a instância é armazenada e replicada. Essa lista de configurações é muito menor do que a disponível para instâncias pagas. Para conferir uma lista das configurações regionais disponíveis para instâncias de teste gratuitas, consulte Configurações de instância disponíveis. Para conferir uma lista completa de todas as configurações de instância disponíveis, consulte Configurações regionais, birregionais e multirregionais.

4. Clique em Criar instância de teste sem custos.

   Depois de criar a instância de teste sem custo, você vai receber uma solicitação para continuar aprendendo e explorando o Spanner ao iniciar um tutorial detalhado que ensina a criar um banco de dados usando um aplicativo de exemplo. Para mais informações, consulte Começar a usar um aplicativo de exemplo.

Criar uma instância de teste gratuita usando a CLI gcloud

Antes de começar

1. 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.
2. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Create or select a Google Cloud project.

   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.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

5. Make sure that billing is enabled for your Google Cloud project.

6. If you're using a local shell, then create local authentication credentials for your user account:

   gcloud auth application-default login

   You don't need to do this if you're using Cloud Shell.

7. Install the Google Cloud CLI.

8. To initialize the gcloud CLI, run the following command:

   gcloud init

9. Create or select a Google Cloud project.

   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.

   • Create a Google Cloud project:

     gcloud projects create PROJECT_ID

     Replace PROJECT_ID with a name for the Google Cloud project you are creating.

   • Select the Google Cloud project that you created:

     gcloud config set project PROJECT_ID

     Replace PROJECT_ID with your Google Cloud project name.

10. Make sure that billing is enabled for your Google Cloud project.

11. If you're using a local shell, then create local authentication credentials for your user account:

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

Criar uma instância de teste gratuito

Para criar uma instância de teste gratuita, use o comando gcloud spanner instances create.

gcloud spanner instances create INSTANCE_ID \
   --instance-type=free-instance --config=INSTANCE_CONFIG \
   --description=INSTANCE_DESCRIPTION

Substitua:

• INSTANCE_ID: um identificador permanente exclusivo no projeto Google Cloud . Não será possível mudar o ID da instância depois.

• INSTANCE_CONFIG: um identificador permanente da configuração da instância, que define o local geográfico dela. É possível criar uma instância de teste gratuito em uma das seguintes configurações regionais:

  • Américas: regional-us-central1 (Iowa), regional-us-east1 (Carolina do Sul), regional-us-east4 (Virgínia do Norte) e regional-us-east5 (Colômbia)
  • Europa: regional-europe-west1 (Bélgica), regional-europe-west3 (Frankfurt)
  • Ásia: regional-asia-northeast1 (Tóquio), regional-asia-south2 (Délhi), regional-asia-southeast2 (Jacarta)

• INSTANCE_DESCRIPTION: o nome a ser exibido para a instância no Console do Google Cloud. O nome da instância precisa ser exclusivo no projeto Google Cloud .

Por exemplo, para criar uma instância de teste gratuita chamada trial-instance com o nome de exibição Trial Instance usando a configuração de instância regional regional-us-east5:

gcloud spanner instances create trial-instance --config=regional-us-east5 \
    --instance-type=free-instance --description="Trial Instance"

Observação: use o ID da instância, e não o nome de exibição, ao se referir a uma instância em comandos gcloud CLI.

Começar a usar um aplicativo de exemplo

O Spanner oferece um exemplo de aplicativo de código aberto para ajudar você a começar a usar a instância de teste gratuito do Spanner. Um aplicativo de exemplo consiste em um serviço gRPC de back-end com o suporte de um banco de dados do Spanner e um gerador de carga de trabalho que direciona o tráfego para o serviço.

É possível acessar o aplicativo de exemplo usando o console do Google Cloud ou a CLI do Google Cloud.

Console

1. Acesse a página Instâncias do Spanner no console do Google Cloud.

   Acessar a página "Instâncias"

2. Clique no nome da instância do teste gratuito.

3. Na página Visão geral da instância, clique em Saiba mais.

4. No painel Aprenda: tutorial, clique em Criar um banco de dados do Cloud SQL ou Criar um banco de dados do PostgreSQL, dependendo do dialeto que você quer usar.

5. Depois de concluir o tutorial, volte ao painel Aprenda: tutorial para seguir o segundo tutorial, Consultar um banco de dados de exemplo.

CLI da gcloud

1. Conclua as etapas descritas na configuração da CLI gcloud, que aborda a criação e a configuração de um projeto padrão do Google Cloud, a ativação da API Cloud Spanner e a configuração do OAuth 2.0 para receber credenciais de autenticação e usar a API Cloud Spanner.

   Execute gcloud auth application-default login para configurar o ambiente de desenvolvimento local com credenciais de autenticação.

2. Execute o comando gcloud spanner samples run para fazer o download do aplicativo de exemplo e iniciar o serviço gRPC de back-end e o gerador de carga de trabalho para o aplicativo de exemplo fornecido:

   gcloud spanner samples run APPNAME --instance-id INSTANCE_ID
   

3. Para mais informações e uma lista de outros comandos disponíveis para o aplicativo de exemplo, consulte a documentação da CLI gcloud.

Fazer upgrade de uma instância de teste gratuito

As etapas a seguir explicam como fazer upgrade da sua instância de teste sem custo financeiro.

Usar o Console do Google Cloud

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

   Acessar a página "Instâncias"

2. Clique no nome da instância do teste gratuito.

3. Na página Visão geral da instância, clique em Editar instância ou Editar para fazer upgrade.

   

4. No campo Atualizar nome da instância, insira um nome mais adequado para sua instância paga, se aplicável.

5. Selecione a Opção de upgrade. Você pode selecionar uma das seguintes opções:

   • Fazer upgrade agora
   • Fazer upgrade automático para a versão completa da Edição Enterprise após o término do período de teste
   • Lembrar mais tarde

   A seção Resumo fornece uma descrição dos custos de computação e armazenamento da instância paga atualizada que você selecionou.

6. Clique em Salvar para fazer upgrade da sua instância de teste gratuito.

Usar a gcloud CLI

Para fazer upgrade da instância de teste gratuita para uma instância paga da edição Enterprise com a mesma configuração, execute o seguinte comando gcloud spanner instances update:

gcloud spanner instances update INSTANCE_ID --instance-type=provisioned

Excluir a instância

Aviso: com a exclusão de uma instância, todos os respectivos bancos de dados também são removidos permanentemente. Não é possível desfazer essa ação. Além disso, não é possível criar outra instância de teste gratuito depois de excluir a primeira. É possível criar uma instância de teste gratuito por ciclo de vida do projeto.

Console

1. Acesse a página Instâncias do Spanner no console do Google Cloud.

   Acessar a página "Instâncias"

2. Clique no nome da instância a ser excluída.

3. Na página Visão geral da instância, clique em Excluir instância.

4. Siga as instruções para confirmar a exclusão da instância.

5. Clique em Excluir.

CLI da gcloud

Para excluir a instância do teste gratuito, use o seguinte comando gcloud spanner instances delete:

gcloud spanner instances delete INSTANCE_ID

A seguir

• Saiba mais sobre as instâncias de teste sem custo financeiro do Spanner.
• Saiba mais sobre as instâncias e os bancos de dados do Spanner.
• Para detalhes sobre os preços do Spanner após o período de teste gratuito, consulte a página de preços.