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
No console Google Cloud , acesse a página Spanner.
Selecione ou crie um Google Cloud projeto, caso ainda não tenha feito isso.
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.
b. Em seguida, clique em 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.
e. Clique em Iniciar um teste gratuito e siga para Criar uma instância de teste gratuito na próxima seção.
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.
gcloud
- 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.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
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.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
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:
- Insira o Nome da instância a ser exibido no console Google Cloud . A instância precisa ser exclusiva no projeto Google Cloud .
- 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.
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.
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)
- Américas:
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
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.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
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
- No console Google Cloud , acesse a página Instâncias do Spanner.
Clique no nome da instância de teste sem custo financeiro.
Na página Visão geral da instância, clique em Editar instância ou Editar para fazer upgrade.
No campo Atualizar nome da instância, insira um nome mais adequado para sua instância paga, se aplicável.
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.
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
Acesse a página Instâncias do Spanner no console Google Cloud .
Clique no nome da instância a ser excluída.
Na página Visão geral da instância, clique em Excluir instância.
Siga as instruções para confirmar a exclusão da instância.
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
- 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 sem custos financeiros, consulte a página de preços.