Administra repositorios de muestra personalizados en Cloud Code para IntelliJ

Un repositorio de muestra es un repositorio de Git que contiene muestras personalizadas que creaste para que tu equipo use a fin de desarrollar aplicaciones.

Esto significa que, dentro de una organización o equipo, puedes configurar repositorios de muestra con Cloud Code, personalizado para tu organización, para ofrecer un conjunto estándar de aplicaciones de inicio, servicios y configuración de infraestructura que otros pueden usar. Esto ayuda a alinear los proyectos nuevos con la pila técnica y los estándares preferidos de la organización, y fomenta la incorporación de prácticas recomendadas al comienzo del ciclo de desarrollo.

Un repositorio de muestra puede ser un repositorio existente de aplicaciones de muestra que ya hayas creado o un nuevo conjunto de muestras que te gustaría que usen otras personas. Para importar un repositorio con Cloud Code, agrega un archivo descriptor de muestra al repositorio.

Cuando estén listos, los repositorios de muestra son fáciles de compartir con tu equipo. Deberán configurar Cloud Code y la URL de Git del repositorio de muestra que se usará. Para los repositorios de Git privados, solo los miembros que tienen acceso al repositorio pueden usar las muestras personalizadas subyacentes.

Para ver un ejemplo de cómo se podría configurar un repositorio de muestra, consulta este repositorio.

Antes de comenzar

Asegúrate de que la versión 2.25.0 o una posterior de Git esté instalada en tu máquina local.

Crea un repositorio de muestra

Para usar un repositorio existente, ve a cómo crear un archivo descriptor de muestra. Para crear un nuevo repositorio para usar como repositorio de muestra, sigue estos pasos:

1. Crea un repositorio de Git nuevo.

   Tu repositorio de Git se puede alojar de forma remota o en tu ubicación local máquina. En este ejemplo, se usa un nuevo repositorio de GitHub, “custom-sample-repo”.

   

2. Agrega directorios de muestra al repositorio.

   Los directorios de muestra pueden contener cualquier cosa y estar ubicados en cualquier lugar quieres en el repositorio. En este ejemplo, se agregaron dos directorios de muestra, “hello-world” y “kubernetes-custom-sample”, a “custom-sample-repo”.

   Se recomienda un archivo readme con instrucciones para usar mejor tus muestras personalizadas.

   

3. Crea un archivo descriptor de muestra.

   Un archivo descriptor de muestra le proporciona información a Cloud Code en tu muestra para crear correctamente tu aplicación. Este archivo debe tener un nombre .cctemplate, debe estar ubicada en tu directorio raíz y debe tener el elemento definido en el sección delesquema del archivo descriptor de muestra.

4. Prueba tu muestra personalizada siguiendo los pasos para Crea una app a partir de una muestra personalizada.

Esquema del descriptor de muestra

Clave	Descripción	Tipo
metadata	Metadatos que usa Cloud Code para leer. Cumple con el esquema de metadatos.	Metadatos
Plantillas	Array de muestras incluidas en un repositorio. Los objetos en este array deben cumplir con el Esquema de muestra.	Array<Sample>
Nombre (opcional)	Nombre del repositorio de muestra.	String

Ejemplo

{
   "metadata":{
      "version":"1"
   },
   "name": "My Sample Repository",
   "templates":[
      {
         "path":"/path/to/sample1_location",
         "name":"My Sample 1",
         "description":"The first sample of its name."
      },
      {
         "path":"/path/to/sample2_location",
         "name":"My Sample 2",
         "description":"The sequel."
      }
   ]
}

Esquema de muestra

Clave	Descripción	Tipo
ruta	La ubicación de la muestra en un repositorio. La ruta de acceso es relativa a la raíz del repositorio.	String
nombre	Nombre de una muestra. El nombre se muestra en un IDE cuando se selecciona una muestra para basar una la aplicación.	String
descripción (opcional)	Descripción de una muestra. La descripción se muestra en un IDE cuando se selecciona una muestra en la que se basará una aplicación.	String

Ejemplo

{
   "path":"path/to/sample1",
   "name":"My Sample 1",
   "description":"The first sample of its name."
}

Esquema de metadatos

Clave	Descripción	Tipo
version	La versión del esquema de muestra que se usará. La única versión válida es 1.	String

Ejemplo

{
   "version":"1"
}

Borra un repositorio de muestra personalizado

Para borrar una muestra personalizada, que la quita del flujo de selección de la aplicación personalizada y de las máquinas de los usuarios, haz lo siguiente:

1. En el archivo settings.json, busca el localPath para la entrada de muestra personalizada.

   "cloudcode.customApplications": [
     {
       "repoUrl": https://github.com/GoogleCloudPlatform/cloud-code-custom-samples-example.git,
       "branchName": "",
       "localPath": "/Users/username/Library/cloud-code/custom-templates/https-github-com-google-cloud-platform-cloud-code-custom-samples-example-git"
     }
   ],
   

2. Borra la carpeta de la plantilla en la ruta de acceso.

   Nota: En Macs, Library es una carpeta oculta.

3. Borra la sección de muestra personalizada del archivo settings.json.

Borra un repositorio de muestra personalizado

Para borrar un repositorio de muestra personalizado de Cloud Code, sigue estos pasos:

1. Navega a Preferences > Tools > Cloud Code > Custom Samples.

2. En la tabla Repositorios de muestra personalizados, selecciona la URL del repositorio que que deseas quitar y haz clic en - Quitar.

   

3. En el cuadro de diálogo de confirmación que aparece, haz clic en Quitar para borrar el repositorio seleccionado de Cloud Code.

Obtenga asistencia

Para enviar comentarios o informar un problema en tu IDE de IntelliJ, ve aTools >Cloud Code >Help / About >Envía comentarios o informa un problema para informar un problema en GitHub o hacer una pregunta en Stack Overflow.