Crea instructivos privados en Cloud Shell

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

Después de crear instructivos con la guía Escribe instructivos en Cloud Shell y seguir las prácticas recomendadas que se detallan en la Guía de estilo del instructivo, puedes alojarlo en un repositorio privado de Git a fin de que esté disponible para tus usuarios.

Aloja instructivos privados

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

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

Inicia la terminal de Cloud Shell. Para una sesión independiente de Cloud Shell, usa shell.cloud.google.com.
Crea un repositorio privado:
```
gcloud source repos create REPO_NAME
```
Clona tu repositorio en Cloud Shell:
```
gcloud source repos clone REPO_NAME
```
Mueve el archivo del instructivo al repositorio creado de forma local:
```
mv PATH/TO/TUTORIAL REPO_NAME/PATH/TO/TUTORIAL
```
Ve a tu repositorio local:
```
cd REPO_NAME
```
Agrega el instructivo a la confirmación:
```
git add .
```
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"
```
Usa el comando git push para agregar el contenido del repositorio de Git local a Cloud Source Repositories:
```
git push origin master
```
Visualiza tu repositorio y su contenido en la consola de Google Cloud:

Open Cloud Source Repositories

Crea un vínculo de Abrir en Cloud Shell

Para ayudar a que tus usuarios accedan al instructivo, puedes usar la función Abrir en Cloud Shell de Cloud Shell que te permite definir cómo acceden los usuarios a tu instructivo. Para obtener detalles sobre cómo personalizar tu vínculo, consulta la guía 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.

Este es un 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 a fin de que tus usuarios lo 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 los 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 tu usuario. Para 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 la Guía para personalizar la imagen de contenedor.