Criar tutoriais particulares no Cloud Shell

O Cloud Shell oferece suporte à criação de tutoriais particulares, permitindo que você crie tutoriais específicos para seu público.

Depois de criar tutoriais usando oComo criar tutoriais no Cloud Shell e seguiram as práticas recomendadas detalhadas no Guia de estilo do tutorial , hospede seu tutorial em um repositório Git particular para disponibilizá-lo aos usuários.

Hospedar tutoriais particulares

Para tornar seu tutorial particular, você precisa de um repositório Git privado para o hospedar. Você pode usar o serviço de hospedagem do repositório Git que preferir. Este guia usa o Cloud Source Repositories. repositórios Git particulares hospedados no Google Cloud.

Observação: para usar o Cloud Source Repositories, você precisa ativar o faturamento nos projeto. Para detalhes sobre o custo do uso do Cloud Source Repositories, consulte a Guia de preços do Cloud Source Repositories.

Para criar um repositório do Cloud Source Repositories para hospedar tutorial:

1. Inicie o terminal do Cloud Shell. Para uma sessão independente do Cloud Shell, use shell.cloud.google.com.

2. Crie um repositório particular:

   gcloud source repos create REPO_NAME
   

3. Clone seu repositório para o Cloud Shell:

   gcloud source repos clone REPO_NAME
   

4. Mova o arquivo de tutorial para o repositório criado localmente:

   mv PATH/TO/TUTORIAL REPO_NAME/PATH/TO/TUTORIAL
   

5. Acesse seu repositório local:

   cd REPO_NAME
   

6. Adicione o tutorial à confirmação:

   git add .
   

7. Confirme os arquivos para o repositório com um comentário descrevendo o histórico desta ação:

   git commit -m "Add private tutorial to Cloud Source Repositories"
   

8. Usando o comando git push, adicione o conteúdo do repositório local ao Cloud Source Repositories:

   git push origin master
   

9. Confira seu repositório e o conteúdo dele no console do Google Cloud:

   Abrir o Cloud Source Repositories

Criar um link "Abrir no Cloud Shell"

Para ajudar os usuários a acessar seu tutorial, use o recurso "Abrir no Cloud Shell" que permite definir como os usuários acessam o tutorial. Para saber mais sobre como personalizar seu link, consulte o guia Abrir no Cloud Shell.

Para um tutorial hospedado em um repositório do Cloud Source Repositories, você precisará definir o parâmetro cloudshell_git_repo com o URL do seu repositório.

Um exemplo de link com cloudshell_git_repo definido:

https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://source.developers.google.com/p/project_name/r/repo_name

Você pode definir o estilo desse link como um botão a ser incorporado à documentação para que os usuários encontrem facilmente:

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://source.developers.google.com/p/project_name/r/repo_name)

Personalizar tutoriais com ferramentas complementares

É possível personalizar ainda mais a experiência de tutorial privado fornecendo aos usuários ferramentas personalizadas para trabalhar com seu tutorial.

Para isso, crie uma imagem do Docker que funcione como um ambiente personalizado do Cloud Shell com todos os pacotes adicionais e configurações personalizadas que você quer disponibilizar para o usuário. Para detalhes sobre como criar uma imagem de contêiner personalizada e atualizar seu link "Abrir no Cloud Shell" para mencionar essa imagem de contêiner, consulte o guia Como personalizar imagens de contêiner.