Crea instructivos privados en Cloud Shell

Cloud Shell admite la creación de instructivos privados, lo que te permite diseñarlos específicamente para tu público.

Después de crear instructivos con la guía Cómo escribir instructivos en Cloud Shell y seguir las prácticas recomendadas que se detallan en la Guía de estilo de instructivos, puedes alojar el instructivo en un repositorio de Git privado para que esté disponible para los usuarios.

Aloja instructivos privados

Si quieres que tu instructivo sea privado, necesitas un repositorio de Git privado para alojarlo. Puedes usar el servicio de hosting de repositorios de Git que prefieras. En esta guía, se usan los repositorios de origen de Cloud, que son repositorios privados de Git alojados en Google Cloud.

Si quieres crear un repositorio de Cloud Source Repositories para alojar tu instructivo privado, sigue estos pasos:

  1. Inicia la terminal de Cloud Shell. Para una sesión independiente de Cloud Shell, usa shell.cloud.google.com.
  2. Cree un repositorio privado:

    gcloud source repos create REPO_NAME
    
  3. Clone su repositorio en Cloud Shell:

    gcloud source repos clone REPO_NAME
    
  4. Mueve el archivo de instructivo a tu repositorio creado de forma local:

    mv PATH/TO/TUTORIAL REPO_NAME/PATH/TO/TUTORIAL
    
  5. Ve a tu repositorio local:

    cd REPO_NAME
    
  6. Agrega el instructivo para confirmar:

    git add .
    
  7. Confirma los archivos en el repositorio con un comentario que describa el historial de esta acción:

    git commit -m "Add private tutorial to Cloud Source Repositories"
    
  8. Usa el comando git push para agregar el contenido del repositorio de Git local a Cloud Source Repositories:

    git push origin master
    
  9. Visualiza el repositorio y su contenido en Google Cloud Console:

    Abrir Cloud Source Repositories

Para ayudar a los usuarios a acceder al instructivo, puedes usar la función de Cloud Shell abierta en Cloud Shell que te permite definir cómo acceden los usuarios al instructivo. Para obtener detalles sobre cómo personalizar tu vínculo, consulta la Guía abierta en Cloud Shell.

Para un instructivo alojado en un repositorio de Cloud Source Repositories, deberás definir el parámetro cloudshell_git_repo con la URL de tu repositorio.

Ejemplo de un vínculo con 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

Puedes diseñar este vínculo como un botón para incorporarlo en tu documentación, de modo que los usuarios puedan encontrarlo fácilmente:

[![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 instructivos con herramientas complementarias

Puedes personalizar aún más tu experiencia de instructivo privada si proporcionas a tus usuarios herramientas personalizadas para que trabajen con tu instructivo.

Para ello, puedes crear una imagen de Docker que funcione como un entorno de Cloud Shell personalizado con todos los paquetes adicionales y las configuraciones personalizadas que deseas que estén disponibles para el usuario. Si deseas obtener detalles para crear una imagen de contenedor personalizada y actualizar el vínculo “Abrir en Cloud Shell” a fin de hacer referencia a esta imagen de contenedor, consulta la guía Personaliza la imagen de contenedor.