Se usó la API de Cloud Translation para traducir esta página.
Switch to English

Configura un repositorio de plantillas

Un repositorio de plantillas es un repositorio de Git con plantillas de inicio que creaste para que tu equipo pueda desarrollar aplicaciones.

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

Un repositorio de plantillas puede ser un repositorio existente de plantillas de aplicación que ya hayas creado o un conjunto de plantillas nuevo que desees que otros usen. Solo deberás agregar un archivo del descriptor de plantilla al repositorio para importarlo con Cloud Code.

Cuando estés listo, los repositorios de plantillas son fáciles de compartir con tu equipo. necesitarán configurar Cloud Code y la URL de Git del repositorio de plantillas. En el caso de los repositorios privados de Git, solo los miembros que tienen acceso al repositorio pueden usar las plantillas personalizadas subyacentes.

Para ver un ejemplo de cómo se puede configurar un repositorio de plantillas, consulta este repositorio de muestra.

Crea un repositorio de plantillas nuevo

Si deseas crear un repositorio de plantillas nuevo, sigue estos pasos:

  1. Crea un repositorio de Git nuevo.

    Tu repositorio de Git se puede alojar de forma remota o en tu máquina local. En este ejemplo, se usa un repositorio nuevo de GitHub, “my-template-repository”.

    Interfaz de creación del repositorio de GitHub con el campo Nombre de repositorio completo con "my-template-repository"

  2. Agrega directorios de plantilla a este repositorio.

    Tus directorios de plantillas pueden contener cualquier cosa y ubicarse en cualquier lugar que desees del repositorio. En este ejemplo, dos directorios de plantilla, "template1" y "template2", que contienen un archivo readme, se agregaron a "my-template-repository".

    Se recomienda un archivo readme con instrucciones sobre cómo usar tus plantillas personalizadas.

    "my-template-repository" con dos directorios de plantillas subyacentes, "template1" y "template2"

  3. Crea un archivo descriptor de plantilla.

    Un archivo descriptor de plantilla le proporciona a Cloud Code la información de tu plantilla para crear correctamente tu aplicación. Este archivo debe llamarse .cctemplate, ubicado en el directorio raíz, y tener el esquema definido en la sección Esquema del archivo del descriptor de plantilla.

Usa un repositorio existente

Si deseas usar un repositorio existente, deberás crear un archivo descriptor de plantillas. Este archivo le proporciona a Cloud Code la información sobre tu plantilla para crear correctamente tu aplicación.

El archivo descriptor de plantilla debe llamarse .cctemplate, ubicado en el directorio raíz, y debe tener el esquema definido en la sección Esquema del archivo del descriptor de plantilla.

Esquema del descriptor de plantilla

Clave Descripción Tipo
metadata Metadatos que usa Cloud Code para leer. Se ajusta al esquema de metadatos. Metadatos
plantillas Arreglo de plantillas contenidas en un repositorio. Los objetos de este arreglo deben cumplir con el esquema de plantilla. Arreglo<Plantilla>
nombre (opcional) Nombre del repositorio de plantillas. String

Ejemplo

{
   "metadata":{
      "version":"1"
   },
   "name": "My Template Repository",
   "templates":[
      {
         "path":"/path/to/template1_location",
         "name":"My Template 1",
         "description":"The first template of its name."
      },
      {
         "path":"/path/to/template2_location",
         "name":"My Template 2",
         "description":"The sequel."
      }
   ]
}

Esquema de la plantilla

Clave Descripción Tipo
ruta de acceso Es la ubicación en la que se encuentra la plantilla dentro de un repositorio.

La ruta de acceso se interpreta como la raíz del repositorio.

String
nombre Nombre de una plantilla.

Esto se muestra en un IDE al seleccionar una plantilla para basar una aplicación.

String
descripción (opcional) Descripción de una plantilla.

Esto se muestra en un IDE al seleccionar una plantilla para basar una aplicación.

String

Ejemplo

{
   "path":"path/to/template1",
   "name":"My Template 1",
   "description":"The first template of its name."
}

Esquema de metadatos

Clave Descripción Tipo
version La versión del esquema de la plantilla que se usa. En la actualidad, la única versión válida es 1. String

Ejemplo

{
   "version":"1"
}

Obtener asistencia

Para enviar comentarios, informa problemas en GitHub o haz preguntas en Stack Overflow.