Crea instructivos privados en Cloud Shell

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

Después de crear los instructivos con la guía de escritura de instructivos en Cloud Shell y seguir las prácticas recomendadas que se detallan en la guía de estilo del instructivo, 101}Puedes alojar tu instructivo en un repositorio privado de Git para ponerlo a disposición de tus usuarios.

Aloja instructivos privados

Para hacer que tu instructivo sea privado, necesitas un repositorio de Git privado para alojarlo. Puedes usar cualquier servicio de hosting de repositorio de Git que prefieras. En esta guía, se usan Cloud Source Repositories. Repositorios de Git privados alojados en Google Cloud.

Para crear un repositorio de Cloud Source Repositories a fin de alojar tu instructivo privado, sigue estos pasos:

  1. Inicie la terminal de Cloud Shell. Para una sesión independiente de Cloud Shell, usa shell.cloud.google.com.
  2. Crea 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 del instructivo al repositorio que creaste de forma local:

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

    cd REPO_NAME
    
  6. Agrega el instructivo que se 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 tu repositorio y su contenido en Google Cloud Console:

    Abrir Cloud Source Repositories

Para ayudar a los usuarios a llegar a tu instructivo, puedes usar la función Abrir en Cloud Shell de Cloud Shell, que te permite definir cómo los usuarios acceden a tu instructivo. Para obtener detalles sobre cómo personalizar tu vínculo, consulta la guía de Abrir 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 editar este vínculo como un botón que puedes incorporar en tu documentación para que los usuarios encuentren 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)

Personaliza instructivos con herramientas de complementos

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

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