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

Neste guia de início rápido, mostramos como usar uma instância de teste sem custos financeiros do Spanner e um aplicativo de amostra. 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 sem custo financeiro

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 Cloud Billing ativado no projeto. Você não vai receber cobranças a menos que faça upgrade da instância de teste gratuito para uma instância paga.

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

Antes de começar

Console

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

    Acessar o Spanner

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

  3. Se o faturamento do Cloud já estiver ativado para seu projeto, vá para Criar uma instância de teste gratuito na próxima seção.

    Se o Faturamento do Cloud não estiver ativado no seu projeto, vincule uma conta do Cloud Billing ou crie uma nova. O Google usa essas informações de pagamento para confirmar sua identidade. Não vamos cobrar pela 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 instância paga.

    a. Clique em Acessar faturamento.

    Captura de tela da caixa de diálogo "Ative o faturamento para continuar usando o Spanner", destacando o botão "Acessar o faturamento".

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

    Captura de tela de uma página mostrando "Este projeto não tem uma conta de faturamento", destacando o botão "Vincular uma conta de faturamento".

    c. Siga as etapas para criar uma conta de faturamento e vincule-a ao seu projeto.

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

    Acessar o Spanner

    e. Clique em Iniciar um teste gratuito e siga para Criar uma instância de teste gratuito na próxima seção.

  4. Opcional: se você já tiver criado uma instância do Spanner no projeto, a página Instâncias do Spanner vai aparecer.

    Clique em Iniciar teste sem custos.

    Captura de tela da página "Instâncias do Spanner", destacando "Criar instância gratuita".

gcloud

  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. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

    gcloud init
  5. Create or select a Google Cloud 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.

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

  7. 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.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

  8. Install the Google Cloud CLI.

  9. If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

    gcloud init
  11. Create or select a Google Cloud 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.

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

  13. 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.

    If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Criar uma instância de teste gratuito

Console

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

Na página Criar sua instância de teste gratuito, faça o seguinte:

  1. Insira o Nome da instância a ser exibido no console Google Cloud . A instância precisa ser exclusiva no projeto Google Cloud .
  2. Insira o ID da instância para identificá-la permanentemente. Ele também precisa ser exclusivo no projeto Google Cloud . Não será possível alterá-lo depois.
  3. Selecione um local de configuração no menu suspenso Região.

    A localização geográfica em que a instância é armazenada e replicada é determinada pela configuração da instância. 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 gratuito, 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 sem custos financeiros.

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

gcloud

Para criar uma instância de teste sem custos financeiros, 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 seu 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 de instância regional:

    • Américas: regional-us-central1 (Iowa), regional-us-east1 (Carolina do Sul), regional-us-east4 (Norte da Virgínia), 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 doGoogle Cloud . O nome da instância precisa ser exclusivo no projetoGoogle Cloud .

Por exemplo, para criar uma instância de teste sem custos financeiros 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"

Começar a usar um aplicativo de exemplo

O Spanner oferece um aplicativo de exemplo 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 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 a Google Cloud CLI.

gcloud

  1. Conclua as etapas descritas em Configuração do gcloud, que aborda a criação e a definição de um projeto Google Cloud padrão, 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 o comando 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 especificado:

    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 instância de teste sem custo financeiro.

Console

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

Acessar a página "Instâncias"

  1. Clique no nome da instância de teste sem custo financeiro.

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

Captura de tela da página "Visão geral da instância" e do botão "Editar para fazer upgrade"

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

  2. 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 oferece uma descrição dos custos de computação e armazenamento da instância paga atualizada que você selecionou.

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

gcloud

Para fazer upgrade da instância de teste gratuito 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

Console

  1. Acesse a página Instâncias do Spanner no console 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.

gcloud

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

gcloud spanner instances delete INSTANCE_ID

A seguir