Crie tutoriais privados no Cloud Shell

O Cloud Shell suporta a criação de tutoriais privados, o que lhe permite criar tutoriais especificamente para o seu público.

Depois de criar tutoriais com o guia Escrever tutoriais no Cloud Shell e seguir as práticas recomendadas detalhadas no Guia de estilo de tutoriais, pode alojar o seu tutorial num repositório Git privado para o disponibilizar aos seus utilizadores.

Apresente tutoriais privados

Para tornar o seu tutorial privado, precisa de um repositório Git privado para o alojar. Pode usar o serviço de alojamento de repositórios Git que preferir. Este guia usa os Cloud Source Repositories; repositórios Git privados alojados no Google Cloud.

Para criar um repositório do Cloud Source Repositories para alojar o seu tutorial privado:

  1. Inicie o terminal do Cloud Shell. Para uma sessão autónoma da Cloud Shell, use shell.cloud.google.com.

  2. Crie um repositório privado:

    gcloud source repos create REPO_NAME

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

    gcloud source repos clone REPO_NAME

  4. Mova o ficheiro do tutorial para o repositório criado localmente:

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

  5. Aceda ao repositório local:

    cd REPO_NAME

  6. Adicione o tutorial para confirmar:

    git add .

  7. Confirme os ficheiros no repositório com um comentário que descreva 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 aos Cloud Source Repositories:

    git push origin master

  9. Veja o seu repositório e o respetivo conteúdo na Google Cloud consola:

    Abra o Cloud Source Repositories

Para ajudar os utilizadores a acederem ao seu tutorial, pode usar a funcionalidade Abrir no Cloud Shell do Cloud Shell, que lhe permite definir a forma como os utilizadores acedem ao seu tutorial. Para ver detalhes sobre como personalizar o seu link, consulte o guia Abrir no Cloud Shell.

Para um tutorial alojado num repositório do Cloud Source Repositories, tem de definir o parâmetro cloudshell_git_repo com o URL do seu repositório.

Um exemplo de um 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

Pode aplicar um estilo a este link como um botão para incorporar na sua documentação para que os utilizadores o 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)

Personalize tutoriais com ferramentas de suplementos

Pode personalizar ainda mais a experiência do tutorial privado fornecendo aos seus utilizadores ferramentas personalizadas para trabalhar com o seu tutorial.

Para tal, pode criar uma imagem do Docker que funcione como um ambiente do Cloud Shell personalizado com todos os pacotes adicionais e configurações personalizadas que quer disponibilizar ao utilizador.