Publicar un plano personalizado en un espacio

Antes de poder personalizar un plano para el catálogo de planos de su espacio, debe publicarlo en el espacio. También puedes ver el plano en la CodeCatalyst consola antes de publicarlo. Puede publicar una versión preliminar o una versión normal del blueprint.

importante

Si desea utilizar paquetes de planos de fuentes externas, tenga en cuenta los riesgos que pueden conllevar dichos paquetes. Eres responsable de los planos personalizados que añadas a tu espacio y del código que generen.

importante

Para publicar un plano personalizado en tu CodeCatalyst espacio, debes iniciar sesión con una cuenta que tenga el rol de administrador del espacio o usuario avanzado en el espacio.

Ver y publicar una versión preliminar de un plano personalizado

Puedes publicar una versión preliminar de tu plano personalizado en tu espacio si quieres añadirlo al catálogo de planos de tu espacio. Esto le permite ver el plano como usuario antes de añadir la versión sin vista previa al catálogo. La versión preliminar le permite publicar sin ocupar una versión real. Por ejemplo, si trabaja en una 0.0.1 versión, puede publicar y añadir una versión preliminar, de forma que las nuevas actualizaciones de una segunda versión puedan publicarse y añadirse como tal0.0.2.

Tras realizar los cambios, reconstruya el paquete del blueprint personalizado ejecutando el package.json archivo y previsualice los cambios.

Para ver y publicar una versión preliminar de un blueprint personalizado

1. Reanude su entorno de desarrollo. Para obtener más información, consulte Reanudación de un entorno de desarrollo.

2. Abra una terminal de trabajo en su entorno de desarrollo.

3. (Opcional) En una terminal de trabajo, instala las dependencias necesarias para tu proyecto si aún no las has instalado. Utilice el siguiente comando:

   yarn

4. (Opcional) Si has realizado cambios en el .projenrc.ts archivo, vuelve a generar la configuración del proyecto antes de crear y previsualizar el blueprint. Utilice el siguiente comando:

   yarn projen

5. Reconstruya y obtenga una vista previa del plano personalizado mediante el siguiente comando. Utilice el siguiente comando:

   yarn blueprint:preview

   Navegue hasta el See this blueprint at: enlace proporcionado para obtener una vista previa del plano personalizado. Comprueba que la interfaz de usuario, incluido el texto, se muestre como esperabas en función de tu configuración. Si desea cambiar el esquema personalizado, puede editar el blueprint.ts archivo, volver a sintetizar el esquema y, a continuación, volver a publicar una versión preliminar. Para obtener más información, consulte Resíntesis.

6. (Opcional) Puedes publicar una versión preliminar de tu plano personalizado, que luego podrás añadir al catálogo de planos de tu espacio. Navega hasta el Enable version [preview version number] at: enlace para publicar una versión preliminar en tu espacio.

Puedes emular la creación de proyectos sin tener que crear un proyecto en CodeCatalyst él. Para sintetizar tu proyecto, usa el siguiente comando:

yarn blueprint:synth

Se genera un plano en la synth/synth.[options-name]/proposed-bundle/ carpeta. Para obtener más información, consulte Síntesis.

Si va a actualizar su esquema personalizado, utilice el siguiente comando para volver a sintetizar el proyecto:

yarn blueprint:resynth

Se genera un plano en la carpeta. synth/synth.[options-name]/proposed-bundle/ Para obtener más información, consulte Resíntesis.

Tras publicar la versión preliminar, puede añadir el plano para que los miembros del espacio puedan utilizarlo para crear nuevos proyectos o añadir proyectos existentes. Para obtener más información, consulte Añadir un plano personalizado a un catálogo de planos de espacio.

Ver y publicar una versión normal de un esquema personalizado

Cuando hayas terminado de desarrollar y previsualizar tu plano personalizado, podrás ver y publicar la nueva versión que quieras añadir al catálogo de planos de tu espacio. El flujo de trabajo de publicación que se genera al crear un proyecto publica automáticamente los cambios que se van introduciendo. Si desactivaste la generación del flujo de trabajo al crear el plano, este no estará disponible automáticamente para añadirlo al catálogo de planos de tu espacio. Puedes seguir publicando tu plano personalizado en tu espacio después de ejecutar un comando. yarn

Para ver y publicar un plano personalizado

1. Reanude su entorno de desarrollo. Para obtener más información, consulte Reanudación de un entorno de desarrollo.

2. Abra una terminal de trabajo en su entorno de desarrollo.

3. • Si optó por no generar el flujo de trabajo de lanzamiento al crear su blueprint, utilice el siguiente comando:

     yarn blueprint:release

     Aún puede navegar hasta el See this blueprint at: enlace proporcionado para ver su plano personalizado.

     Publica la versión actualizada de tu plano personalizado, que luego podrás añadir al catálogo de planos de tu espacio. Navega hasta el Enable version [release version number] at: enlace para publicar la última versión en tu espacio.

   • Si optó por un flujo de trabajo de publicación al crear su blueprint, la última versión del blueprint se publicará automáticamente cuando se introduzcan cambios. Utilice los siguientes comandos:

     git add .

     git commit -m "commit message"

     git push

Tras publicar tu versión normal, puedes añadir el esquema para que los miembros del espacio puedan usarlo para crear nuevos proyectos o añadir proyectos existentes. Para obtener más información, consulte Añadir un plano personalizado a un catálogo de planos de espacio.

Publicar y añadir un plano personalizado en espacios y proyectos específicos

De forma predeterminada, los blueprint:release comandos blueprint:preview y se publican en el CodeCatalyst espacio en el que se creó el plano. Si tiene varios espacios empresariales, también puede previsualizar y publicar el mismo plano en esos espacios. También puedes añadir un plano a un proyecto existente de otro espacio.

Para publicar o añadir un plano personalizado en un espacio específico

1. Reanude su entorno de desarrollo. Para obtener más información, consulte Reanudación de un entorno de desarrollo.

2. Abra una terminal de trabajo en su entorno de desarrollo.

3. (Opcional) Instala las dependencias necesarias para tu proyecto si aún no las has instalado. Utilice el siguiente comando:

   yarn

4. Usa la --space etiqueta para publicar una vista previa o una versión normal en un espacio específico. Por ejemplo:

   • yarn blueprint:preview --space my-awesome-space # publishes under a "preview" version tag to 'my-awesome-space'

     Ejemplo de salida:

     Enable version 0.0.1-preview.0 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
     Blueprint applied to [NEW]: https://codecatalyst.aws/spaces/my-awesome-space/blueprints/%40amazon-codecatalyst%2Fmyspace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1-preview.0/projects/create

   • yarn blueprint:release --space my-awesome-space # publishes normal version to 'my-awesome-space'

     Ejemplo de salida:

     Enable version 0.0.1 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
     Blueprint applied to [NEW]: https://codecatalyst.aws/spaces/my-awesome-space/blueprints/%40amazon-codecatalyst%2Fmyspace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1/projects/create

   Utilice la --project para añadir una versión preliminar de un esquema personalizado a un proyecto existente en un espacio específico. Por ejemplo:

   yarn blueprint:preview --space my-awesome-space --project my-project # previews blueprint application to an existing project

   Ejemplo de salida:

   Enable version 0.0.1-preview.1 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
   Blueprint applied to [my-project]: https://codecatalyst.aws/spaces/my-awesome-space/projects/my-project/blueprints/%40amazon-codecatalyst%2FmySpace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1-preview.1/add