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

Neste guia de início rápido, mostramos como usar uma instância de teste gratuito do Spanner e um aplicativo de amostra.

Para mais informações, consulte a visão geral das instâncias de teste gratuito do Spanner.

Começar a usar 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 Cloud Billing ativado no projeto. Você não serão cobrados, a menos que você opte por fazer upgrade sua instância de teste gratuito para uma instância paga.

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

Observação: só é possível criar uma instância de teste gratuito por ciclo de vida do projeto e uma máximo de 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 gratuito usando a 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 do Spanner, clique em Fazer um teste gratuito.

   

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

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

   a. Clique em Acessar o faturamento.

   

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

   

   Observação :se você é um novo cliente do Google Cloud, também pode ter qualificação para o Teste gratuito de 90 dias do Google Cloud com US$ 300 que oferece US $300 em créditos do Cloud Billing para pagar qualquer Google Cloud do Google Cloud. A instância de teste gratuito do Spanner é um complemento os créditos de US $300 oferecidos pela avaliação gratuita do Google Cloud, e você não precisa usar créditos gratuitos do Cloud Billing para criar um instância de teste gratuito.

   c. Siga as etapas para Criar uma conta de faturamento e vincule-a ao seu em um projeto de IA.

   d. Depois de ativar o Cloud Billing para seu projeto, acesse Spanner.

   Acessar o Spanner

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

5. Opcional: se você criou uma instância do Spanner no projeto antes, você verá a seguinte página Instâncias do Spanner.

   Clique em Iniciar um teste gratuito.

   

Criar uma instância de teste gratuito

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

1. No campo Nomeie sua instância, insira um nome de instância, como Trial instance.

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

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

   A configuração da sua instância determina a localização geográfica é armazenada e replicada. Esta lista de configurações é muito menor do que a lista disponível para instâncias pagas. Para uma lista dos configurações regionais disponíveis para instâncias de teste gratuito, consulte Configurações de instância disponíveis. Para 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 gratuito.

   

   Depois de criar sua instância de teste gratuito, você será solicitado a continuar aprendendo e conhecendo o Spanner com um guia tutorial que ensina como criar um banco de dados usando um exemplo para o aplicativo. Para saber mais, consulte Começar com um exemplo aplicativo.

Criar uma instância de teste gratuito 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

1. Crie uma instância 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, 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 aplicativo de amostra 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 apoiado por uma um banco de dados do Spanner e um gerador de carga de trabalho que direciona o tráfego para o serviço.

Para acessar o aplicativo de exemplo, use o console do Google Cloud ou a Google Cloud CLI.

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

4. No painel Aprenda: tutorial, clique em Criar uma amostra do Cloud SQL. banco de dados ou Criar um banco de dados PostgreSQL de amostra, dependendo em qual dialeto você quer começar.

5. Depois de concluir o tutorial, volte para a Saiba mais: tutorial para seguir o segundo tutorial, Consulta um banco de dados de amostra.

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, ativar a API Cloud Spanner e configurar o OAuth 2.0 para receber a autenticação credenciais para usar a API Cloud Spanner.

   Verifique se você executou gcloud auth application-default login. para configurar seu ambiente de desenvolvimento local com autenticação credenciais.

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

   gcloud spanner samples run APPNAME --instance-id INSTANCE_ID
   

3. Para obter mais informações e uma lista de outros comandos disponíveis para o exemplo de aplicativo, 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 gratuito.

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, insira um nome mais adequado para o se aplicável.

5. Selecione sua opção de upgrade.

   A seção Resumo apresenta uma descrição dos recursos de computação e armazenamento para a instância paga atualizada que você selecionou.

   

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

Usar a gcloud CLI

Para fazer upgrade da sua instância de teste gratuito trial-instance para uma instância paga com a mesma configuração de instância, execute o seguinte comando:

gcloud spanner instances update trial-instance --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. Essa ação não pode ser desfeita. Além disso, não é possível criar instância de teste depois de excluir sua primeira instância de teste gratuito. Você pode 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 sua instância de teste gratuito trial-instance, use o seguinte comando:

gcloud spanner instances delete trial-instance

A seguir

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