Esta página foi traduzida pela API Cloud Translation.

Crie e gerencie secrets com o Cloud Code

Saiba como criar e gerenciar secrets usando o Secret Manager do Cloud Code integração total.

Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientação:

Antes de começar

In the Google Cloud console, go to the project selector page.

Go to project selector
Select or create 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.
Instale o Git para que O Cloud Code pode executar operações do Git, como a clonagem de uma amostra.

Instale o plug-in do Cloud Code. caso ainda não tenha feito isso.

Criar o serviço do Cloud Run

Usar o editor do Cloud Shell como ambiente para criar o serviço do Cloud Run e secreto. Ele vem pré-carregado com as ferramentas necessárias para desenvolvimento na nuvem.

Siga estas etapas para criar o serviço:

Na barra de status do Cloud Code, clique no nome do projeto ativo.
No menu "Escolha rápida" que aparece, clique em Novo aplicativo e e clique em Aplicativo do Cloud Run.
Na lista de amostras do Cloud Run, selecione Python (Flask): Cloud Run.
Selecione uma pasta para usar como exemplo e clique em Criar novo aplicativo.

Depois que o editor do Cloud Shell carregar seu serviço em um novo espaço de trabalho, confira os arquivos em o explorador visualização.

Criar um secret

Com o Secret Manager, armazenar, gerenciar e acessar secrets com segurança como blobs binários ou strings de texto. Além disso, ele gerencia os secrets, o que significa que você não precisa lidar máquinas virtuais ou serviços operacionais.

Para criar um secret com a integração do Secret Manager do Cloud Code:

Clique em Secreto Manager e aguarde o carregamento.
Se for preciso autorizar o Cloud Shell a fazer chamadas de API do Google Cloud, Clique em Autorizar.
Clique em Adicionar. Criar Secret.
Se solicitado, escolha seu projeto do Google Cloud no seletor suspenso.
Se solicitado, ative a API Secret Manager.
Na guia Secret Manager - Criar secret exibida, insira seguindo no campo Nome:
```
my-secret
```
No campo Valor do secret, insira:
```
Hello secret!
```
Clique em Criar secret e em uma mensagem informando que sua chave secreta foi recebida com sucesso. criado aparece.

Adicione um secret ao código

Secrets são ótimos para armazenar informações de configuração, como senhas, chaves de API ou certificados TLS necessários para um aplicativo no tempo de execução.

Para adicionar um secret ao código:

Abra o Google Cloud API e selecione a API Secret Manager.

Isso abre a guia "Detalhes da API do Google Cloud" com a API Secret Manager como
Na seção Instalar biblioteca de cliente, clique na guia Python e Clique em play_arrow Executar no terminal. Isso instala a biblioteca de cliente google-cloud-secret-manager.
Abrir requirements.txt e adicione a seguinte linha ao final do arquivo:
```
google-cloud-secret-manager==2.1.0
```
Suas alterações são salvas automaticamente.

Para acessar o valor mais recente do secret, abra app.py e copie e cole a seguinte função: após a função "hello":

def access_secret_version(secret_version_id):
    """Return the value of a secret's version"""
    from google.cloud import secretmanager

    # Create the Secret Manager client.
    client = secretmanager.SecretManagerServiceClient()

    # Access the secret version.
    response = client.access_secret_version(name=secret_version_id)

    # Return the decoded payload.
    return response.payload.data.decode('UTF-8')

Para chamar a função access_secret_version, substitua o variável da mensagem pelo seguinte:
```
message = access_secret_version("<SECRET_VERSION_ID>")
```
Se a guia Secret Manager - Criar secret ainda estiver aberta, file_copy Copie o ID.

Para conseguir o ID de uma versão do secret a qualquer momento, acesse Secreto Administrador > [SECRET_NAME] > Versões, devem conter o passe o cursor sobre sua versão e clique em Copiar ID do recurso.
Para adicionar o ID da versão, substitua o marcador <SECRET_VERSION_ID> pelo ID da versão copiado.

Executar no emulador do Cloud Run

Para testar o novo secret, execute o serviço do Cloud Run localmente no emulador do Cloud Run.

Abra o menu Cloud Code na barra de status.
Para criar e implantar seu serviço no emulador, selecione Executar no emulador do Cloud Run.
Na guia "Executar/Depurar no emulador do Cloud Run" que aparece, clique em Executar.
Ao executar a configuração pela primeira vez, esse processo pode exigir a 5 minutos. O Saída exibe o progresso da criação e implantação do app.
Após a criação do seu app, inicie-o clicando no link do host local aparece na Saída do painel de controle. O valor do secret é exibido abaixo do gráfico de sucesso.

Acessar e criar uma nova versão do secret

A visualização do Secret Manager do Cloud Code mostra rapidamente as secrets, com ações para gerenciá-los.

Como visualizar o valor de uma versão do secret

Clique no botão Secreto Manager.
Clique para abrir o secret.
Na pasta Versões, clique com o botão direito do mouse na versão numerada que você quer para conferir o valor e selecione Mostrar valor da versão.

Não é possível editar uma versão do secret. Para atualizar o valor de um secret, você precisa criar um nova versão.

Criar uma nova versão do secret

O valor de um secret é armazenado em uma versão do secret. Um secret pode ter várias mais recentes. Isso é útil em situações em que um secret muda. Atualizar um com uma nova versão do secret, você não precisa atualizar seu código.

Clique no botão Secreto Manager.
Clique com o botão direito do mouse no nome do secret e selecione Criar versão do secret.
Na guia Secret Manager – Criar versão, insira um novo valor. e clique em Criar versão.
Depois que a guia Secret Manager - Criar secret abrir, clique em file_copy Copiar a cópia na parte superior do ID.
Para adicionar o ID da versão mais recente, substitua a versão atual que aparece na mensagem no app.py pelo ID da versão mais recente que você copiou.

Se você sempre quiser que o código use a versão mais recente, substitua o número da versão no final do seu ID de versão por latest.

Ver e gerenciar secrets

Desativar uma versão do secret

Versões de secrets são ativadas por padrão após a criação, o que significa que podem ser acessados. Um secret desativado fica inacessível, mas é possível restaurar o acesso a qualquer momento a ele a qualquer momento.

Para desativar uma versão do secret:

Clique em . Cloud Code e, em seguida, expandir a seção Secret Manager.
Clique para abrir o secret.
Na pasta Versions, clique com o botão direito do mouse na versão numerada que você quer desativar.
Selecione Desativar versão.

Destruir uma versão de secret

Quando você destrói uma versão do secret, ela não pode ser acessada. A destruição de uma versão do secret é permanente.

Clique em . Cloud Code e, em seguida, expandir a seção Secret Manager.
Clique para abrir o secret.
Na pasta Versions, clique com o botão direito do mouse na versão que você quer destruir.
Selecione Destruir versão.

Limpar

Para excluir apenas o cluster que você criou para este guia de início rápido:

Clique em . Cloud Code e, em seguida, expandir a seção Kubernetes.
Mantenha o ponteiro sobre o nome do cluster e clique em open_in_new Abrir no console do Google Cloud.
Clique em Excluir e em Excluir.

Para excluir o projeto (e os recursos associados, incluindo os clusters):

Acesse a página "Projetos" no Console do Google Cloud.

Acessar a página "Projetos"
Selecione o projeto que você criou para este guia de início rápido e clique em Excluir.
Digite o ID do projeto para confirmar e clique em Encerrar.

Isso encerrará o projeto e programará a remoção dele.