Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Cómo empezar con los planos personalizados
Durante el proceso de creación de un plano, puedes configurarlo y generar una vista previa de los recursos del proyecto. Cada plano personalizado es gestionado por un CodeCatalyst proyecto, que contiene un flujo de trabajo de forma predeterminada para su publicación en el catálogo de planos del espacio.
Al configurar los detalles de tu plano personalizado, también puedes optar por almacenar el código fuente del plano en un repositorio externo, donde podrás gestionar el plano personalizado y utilizar las funciones de gestión del ciclo de vida para mantener sincronizados los proyectos del espacio cuando se modifique el plano personalizado. Para obtener más información, consulte Añada funcionalidad a los proyectos con extensiones en CodeCatalyst y Trabajar con la administración del ciclo de vida como autor de un plan.
Si ya dispones de un repositorio de código fuente con normas estandarizadas y prácticas recomendadas, puedes optar por convertir ese repositorio de código fuente en un plan personalizado. Para obtener más información, consulte Convertir los repositorios de origen en planos personalizados.
Temas
Requisitos previos
Antes de crear un esquema personalizado, tenga en cuenta los siguientes requisitos:
Tu CodeCatalyst espacio debe ser del nivel Enterprise. Para obtener más información, consulta Gestión de la facturación en la Guía del CodeCatalyst administrador de Amazon.
Debe tener el rol de administrador del espacio o de usuario avanzado para crear planos personalizados. Para obtener más información, consulte Concesión de acceso con roles de usuario.
Paso 1: Crea un plano personalizado en CodeCatalyst
Cuando creas un plano personalizado a partir de la configuración de tu espacio, se crea un repositorio para ti. El repositorio incluye todos los recursos necesarios que debes tener para desarrollar tu plano antes de publicarlo en el catálogo de planos del espacio.
Para crear un plano personalizado
Abra la CodeCatalyst consola en https://codecatalyst.aws/
. En la CodeCatalyst consola, navegue hasta el espacio en el que desee crear un plano personalizado.
En el panel de control del espacio, selecciona la pestaña Configuración y, a continuación, selecciona Planos.
Selecciona Crear plano.
En Asigne un nombre a su plano, introduzca el nombre que desee asignar al proyecto y los nombres de los recursos asociados. El nombre debe ser único dentro de su espacio.
-
(Opcional) De forma predeterminada, el código fuente creado por el blueprint se almacena en un CodeCatalyst repositorio. Como alternativa, puede optar por almacenar el código fuente del blueprint en un repositorio de terceros. Para obtener más información, consulte Añada funcionalidad a los proyectos con extensiones en CodeCatalyst.
Realice una de las siguientes acciones en función del proveedor de repositorios externo que desee utilizar:
-
GitHub repositorios: Conecta una GitHub cuenta.
Seleccione el menú desplegable Avanzado, elija GitHub el proveedor del repositorio y, a continuación, elija la GitHub cuenta en la que desee almacenar el código fuente creado por el blueprint.
nota
Si utilizas una conexión a una GitHub cuenta, debes crear una conexión personal para establecer un mapeo de identidad entre tu CodeCatalyst identidad y tu GitHub identidad. Para obtener más información, consulte Conexiones personales y Acceder a GitHub los recursos con conexiones personales.
-
Repositorios de Bitbucket: Conecta un espacio de trabajo de Bitbucket.
Selecciona el menú desplegable Avanzado, elige Bitbucket como proveedor del repositorio y, a continuación, elige el espacio de trabajo de Bitbucket en el que quieres almacenar el código fuente creado por el blueprint.
-
GitLab repositorios: Conecta a un GitLab usuario.
Seleccione el menú desplegable Avanzado, elija GitLab el proveedor del repositorio y, a continuación, elija el GitLab usuario en el que desee almacenar el código fuente creado por el blueprint.
-
-
En Detalles del esquema, haga lo siguiente:
En el campo de introducción de texto con el nombre para mostrar del plano, introduce un nombre que aparecerá en el catálogo de planos de tu espacio.
En el campo de entrada de texto Descripción, introduce una descripción para tu plano personalizado.
En el campo de entrada de texto del nombre del autor, introduzca un nombre de autor para el esquema personalizado.
-
(Opcional) Seleccione la configuración avanzada.
Seleccione + Añadir para añadir las etiquetas que se añadirán al
package.jsonarchivo.Seleccione el menú desplegable Licencia y, a continuación, elija una licencia para su plano personalizado.
En el campo de entrada de texto del nombre del paquete de blueprint, introduzca un nombre para identificar su paquete de blueprint.
De forma predeterminada, el flujo de trabajo de publicación se genera mediante un esquema de publicación del proyecto denominado Blueprint Builder. El flujo de trabajo publica la última versión del blueprint en tu espacio cuando insertas cambios, ya que el flujo de trabajo de publicación habilita los permisos de publicación. Para desactivar la generación del flujo de trabajo, desmarca la casilla Publicar flujo de trabajo.
(Opcional) Un proyecto de plano viene con un código predefinido para facilitar la publicación del plano en el catálogo de planos del espacio. Para ver los archivos de definición con actualizaciones basadas en las selecciones de parámetros del proyecto que haya realizado, seleccione Ver código o Ver flujo de trabajo en la vista previa de Generar planos.
Seleccione Crear plano.
Si no ha desactivado la generación del flujo de trabajo para su blueprint personalizado, el flujo de trabajo comienza a ejecutarse automáticamente cuando se crea el blueprint. Cuando se complete la ejecución del flujo de trabajo, tu plano personalizado estará disponible para añadirlo al catálogo de planos de tu espacio de forma predeterminada. Puedes desactivar los permisos de publicación si no quieres que la última versión del plano se publique automáticamente en tu espacio. Para obtener más información, consulte Configuración de permisos de publicación para un blueprint personalizado y Ejecución de un flujo de trabajo.
Como el flujo de trabajo de publicación denominado blueprint-release se crea mediante un esquema, el esquema se puede encontrar como un esquema aplicado en el proyecto. Para obtener más información, consulte Añadir un plan a un proyecto para integrar los recursos y Desasociar un blueprint de un proyecto para detener las actualizaciones.
Paso 2: Desarrolle un esquema personalizado con componentes
Al crear un esquema personalizado, se genera un asistente de planos, que se puede modificar con componentes al desarrollar el esquema personalizado. Puede actualizar los src/defaults.json archivos src/blueprints.js y para modificar el asistente.
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.
Crea un entorno de desarrollo en tu CodeCatalyst proyecto con un entorno de desarrollo integrado (IDE) compatible antes de configurar el código del blueprint. Se necesita un entorno de desarrollo para trabajar con las herramientas y los paquetes necesarios.
Para crear un entorno de desarrollo
-
En el panel de navegación, realice una de las siguientes acciones:
Seleccione Descripción general y, a continuación, vaya a la sección Mis entornos de desarrollo.
Selecciona Código y, a continuación, selecciona Entornos de desarrollo.
Elija Código, repositorios de código fuente y elija el repositorio que creó al crear su blueprint.
Seleccione Crear entorno de desarrollo.
Elija un IDE compatible en el menú desplegable. Consulte Entornos de desarrollo integrados compatibles para entornos de desarrollo para obtener más información.
Selecciona Trabajar en una rama existente y, en el menú desplegable de la rama existente, selecciona la rama de funciones que has creado.
(Opcional) En el campo de entrada de texto Alias: opcional, introduce un alias para identificar el entorno de desarrollo.
Seleccione Crear. Mientras se crea el entorno de desarrollo, la columna de estado del entorno de desarrollo muestra Inicio y la columna de estado muestra En ejecución cuando se ha creado el entorno de desarrollo.
Para obtener más información, consulte Escribe y modifica código con entornos de desarrollo en CodeCatalyst.
Para desarrollar su plan personalizado
-
En una terminal que funcione, utilice el siguiente
yarncomando para instalar las dependencias:yarnLas herramientas y los paquetes necesarios están disponibles a través del entorno de CodeCatalyst desarrollo, incluido Yarn. Si está trabajando en un plan personalizado sin un entorno de desarrollo, instale primero Yarn en su sistema. Para obtener más información, consulta la documentación de instalación de Yarn
. -
Desarrolle su plano personalizado para que se configure según sus preferencias. Puede modificar el asistente del blueprint añadiendo componentes. Para obtener más información, consulte Desarrollo de un plan personalizado para cumplir con los requisitos del proyecto, Modificación de las funciones del blueprint con un asistente de front-end y Publicar un plano personalizado en un espacio.
Paso 3: Obtenga una vista previa de un plano personalizado
Tras configurar y desarrollar tu plano personalizado, puedes previsualizar y publicar la versión preliminar del plano en tu espacio. Una versión de vista previa te permite comprobar si el plano es lo que deseas antes de usarlo para crear nuevos proyectos o aplicarlo a proyectos existentes.
Para obtener una vista previa de un plano personalizado
-
En una terminal que funcione, utilice el siguiente
yarncomando:yarn blueprint:preview -
Navegue hasta el
See this blueprint at:enlace proporcionado para obtener una vista previa de su 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.tsarchivo, 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.
(Opcional) Paso 4: Publicar una versión preliminar del blueprint personalizada
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 tener que utilizar 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.
Para publicar una versión preliminar de un blueprint personalizado
Navegue hasta el Enable version enlace proporcionado para activar su esquema personalizado. Este enlace se proporciona al ejecutar el [version number] at:yarn comando enPaso 3: Obtenga una vista previa de un plano personalizado.
Tras crear, desarrollar, previsualizar y publicar tu plano personalizado, puedes publicar y añadir la versión final del plano al catálogo de planos de tu espacio. Para obtener más información, consulte Publicar un plano personalizado en un espacio y Añadir un plano personalizado a un catálogo de planos de espacio.
