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 o guia Como criar tutoriais no Cloud Shell e seguir as práticas recomendadas detalhadas no Guia de estilo do tutorial, hospede seu tutorial em um repositório Git particular para disponibilizá-lo para seus usuários.

Você pode usar o serviço de hospedagem do repositório Git que preferir. Este guia usa Secure Source Manager, um repositório de código-fonte gerenciado de locatário único e implantado regionalmente hospedado em Google Cloud, para demonstrar as etapas.

Criar um repositório Git particular

As instâncias do Secure Source Manager são implantadas em uma região disponível Google Cloud e podem ser acessadas pelos URIs da instância. Os repositórios são criados na instância do Secure Source Manager usando uma interface da Web ou a API Secure Source Manager.

Para criar um repositório do Secure Source Manager para hospedar seu tutorial particular, siga estas etapas.

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

  2. Crie uma instância do Secure Source Manager se você ainda não tiver uma:

    gcloud source-manager instances create INSTANCE_ID \
    --region=LOCATION

    Substitua:

    • INSTANCE_ID: o ID da instância do Secure Source Manager.
    • LOCATION: a região em que você está criando a instância, por exemplo, us-central1.

    A criação da instância pode levar até 60 minutos.

  3. Para acessar a instância do Secure Source Manager pela interface da Web, copie o URL a seguir na barra de endereço do navegador:

    INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

    Substitua PROJECT_NUMBER pelo número do projeto da instância Google Cloud .

  4. Crie um repositório particular:

    gcloud source-manager repos create REPO_ID \
    --instance=INSTANCE_ID \
    --region=LOCATION

    Substitua REPO_ID pelo ID do repositório do Secure Source Manager.

    Para informações sobre as permissões necessárias para criar um repositório, consulte Papéis necessários.

  5. Adicione o auxiliar de autenticação do Secure Source Manager à configuração global do Git. Para mais informações, consulte Configurar suas credenciais.

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

    git clone https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev/PROJECT_ID/REPO_ID.git

    Substitua PROJECT_ID pelo ID do projeto da instância. Google Cloud

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

    mv PATH_TO_TUTORIAL REPO_ID/PATH_TO_TUTORIAL

    Substitua PATH_TO_TUTORIAL pelo caminho do seu tutorial particular.

  8. Acesse seu repositório local:

    cd REPO_ID

  9. Adicione, confirme e envie os arquivos de tutorial por push:

    git add .
git commit -m "Add private tutorial to Secure Source Manager"
git push origin main

  10. É possível visualizar o repositório do Secure Source Manager na interface da Web. Para mais informações, consulte Listar e visualizar repositórios.

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 Secure Source Manager, você precisará definir o parâmetro cloudshell_git_repo com o URL HTTPS do seu repositório. Exemplo:

https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev/PROJECT_ID/REPO_ID.git

Você pode definir o estilo desse link como um botão e incorporá-lo à documentação para que os usuários encontrem. Exemplo:

[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://INSTANCE_ID-PROJECT_NUMBER-git.LOCATION.sourcemanager.dev/PROJECT_ID/REPO_ID.git)

Como 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 Docker que funcione como um ambiente shell personalizado do Cloud Shell com todos os pacotes adicionais e configurações personalizadas que você quer disponibilizar para o usuário.