Amazon ya no CodeCatalyst está abierto a nuevos clientes. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cómo migrar desde CodeCatalyst](migration.md).
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.
# Introducción a los esquemas personalizados
Durante el proceso de creación de un esquema, puede configurarlo y generar una vista previa de los recursos del proyecto. Todos los esquemas personalizados están administrados por un proyecto de CodeCatalyst que, de forma predeterminada, contiene un flujo de trabajo para la publicación en el catálogo de esquemas del espacio.
Al configurar los detalles de un esquema personalizado, también puede optar por almacenar el código fuente del esquema en un repositorio externo, donde podrá seguir administrando el esquema personalizado y utilizar las capacidades de administración del ciclo de vida para mantener los proyectos del espacio sincronizados cuando se modifique el esquema personalizado. Para obtener más información, consulte [Añada funcionalidad a los proyectos con extensiones en CodeCatalystAdición de funcionalidad a proyectos mediante extensiones](extensions.md) y [El trabajo del autor de esquemas con la administración del ciclo de vida](lifecycle-management-dev.md).
Si ya dispone de un repositorio de código fuente con normas estandarizadas y prácticas recomendadas, puede optar por convertir ese repositorio de código fuente en un esquema personalizado. Para obtener más información, consulte [Conversión de los repositorios de código fuente en esquemas personalizados](convert-bp.md).
**Topics**
+ [Requisitos previos](#prerequisites-bp)
+ [Paso 1: creación de un esquema personalizado en CodeCatalyst](#getting-started-create-bp)
+ [Paso 2: desarrollo de un esquema personalizado con componentes](#getting-started-develop-bp)
+ [Paso 3: obtención de una vista previa de un esquema personalizado](#getting-started-publish-bp)
+ [(Opcional) Paso 4: publicación de una versión preliminar de un esquema personalizado](#getting-started-add-bp)
## Requisitos previos
Antes de crear un esquema personalizado, tenga en cuenta los siguientes requisitos:
+ El espacio de CodeCatalyst debe tener el nivel **Enterprise**. Para obtener más información, consulte [Managing billing](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-view-plan.html) en la Guía del administrador de Amazon CodeCatalyst.
+ Para crear esquemas personalizados, debe tener el rol de **administrador del espacio** o **usuario avanzado**. Para obtener más información, consulte [Concesión de acceso en los roles de usuario](ipa-roles.md).
## Paso 1: creación de un esquema personalizado en CodeCatalyst
Cuando crea un esquema personalizado a partir de la configuración del espacio, se crea un repositorio automáticamente. El repositorio incluye todos los recursos necesarios que debe tener para desarrollar el esquema antes de publicarlo en el catálogo de esquemas del espacio.
**Creación de un esquema personalizado**
1. Abra la consola de CodeCatalyst en [https://codecatalyst.aws/](https://codecatalyst.aws/).
1. En la consola de CodeCatalyst, vaya al espacio donde desee crear un esquema personalizado.
1. En el panel de control del espacio, elija la pestaña **Configuración** y, a continuación, elija **Esquemas**.
1. Seleccione **Crear esquema**.
1. En **Asignar nombre al esquema**, introduzca el nombre que desea asignar al proyecto y los nombres de los recursos asociados. El nombre debe ser único dentro de su espacio.
1. (Opcional) De forma predeterminada, el código fuente creado por el esquema se almacena en un repositorio de CodeCatalyst. También puede elegir almacenar el código fuente del esquema en un repositorio de terceros. Para obtener más información, consulte [Añada funcionalidad a los proyectos con extensiones en CodeCatalystAdición de funcionalidad a proyectos mediante extensiones](extensions.md).
Realice una de las siguientes acciones en función del proveedor de repositorios de terceros que desee utilizar:
+ **Repositorios de GitHub**: conéctese a una cuenta de GitHub.
Seleccione el menú desplegable **Avanzado**, elija GitHub como proveedor del repositorio y, a continuación, elija la cuenta de GitHub en la que desee almacenar el código fuente creado por el esquema.
**nota**
Si utiliza una conexión a una cuenta de GitHub, debe crear una conexión personal para establecer una correspondencia de identidades entre su identidad de CodeCatalyst y la de GitHub. Para obtener más información, consulte [Conexiones personales](concepts.md#personal-connection-concept) y [Acceder a GitHub los recursos con conexiones personales](ipa-settings-connections.md).
+ **Repositorios de Bitbucket**: conéctese a un espacio de trabajo de Bitbucket.
Seleccione el menú desplegable **Avanzado**, elija Bitbucket como proveedor del repositorio y, a continuación, elija el espacio de trabajo de Bitbucket en el que desee almacenar el código fuente creado por el esquema.
+ **Repositorios de GitLab**: conéctese a un usuario de GitLab.
Seleccione el menú desplegable **Avanzado**, elija GitLab como proveedor del repositorio y, a continuación, elija el usuario de GitLab en el que desee almacenar el código fuente creado por el esquema.
1. En **Detalles del esquema**, haga lo siguiente:
1. En el campo de entrada de texto **Nombre de visualización del esquema**, introduzca el nombre que aparecerá en el catálogo de esquemas del espacio.
1. En el campo de introducción de texto **Descripción**, escriba una descripción del esquema personalizado.
1. En el campo de entrada de texto **Nombre del autor**, introduzca un nombre de autor para el esquema personalizado.
1. (Opcional) Seleccione **Configuración avanzada**.
1. Seleccione **\$1 Añadir** para añadir las etiquetas que se añadirán al archivo `package.json`.
1. Seleccione el menú desplegable **Licencia** y, a continuación, elija una licencia para el esquema personalizado.
1. En el campo de entrada de texto **Nombre del paquete del esquema**, introduzca un nombre para identificar al paquete del esquema.
1. De forma predeterminada, el flujo de trabajo de publicación se genera mediante un esquema de publicación dentro del proyecto, denominado **Blueprint Builder**. El flujo de trabajo publica la última versión del esquema en el espacio cuando envía los 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, desmarque la casilla **Publicar flujo de trabajo**.
1. (Opcional) Un proyecto de esquema viene con código predefinido para facilitar la publicación del esquema en el catálogo de esquemas 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 **Generar vista previa de esquema**.
1. Seleccione **Crear esquema**.
Si no ha desactivado la generación del flujo de trabajo para el esquema personalizado, el flujo de trabajo comenzará a ejecutarse automáticamente cuando se cree el esquema. Cuando se complete la ejecución del flujo de trabajo, el esquema personalizado estará disponible, de forma predeterminada, para la adición en el catálogo de esquemas del espacio. Puede desactivar los permisos de publicación si no quiere que la última versión del esquema se publique automáticamente en el espacio. Para obtener más información, consulte [Configuración de permisos de publicación para un esquema personalizado](manage-permissions-bp.md) y [Ejecución de un flujo de trabajo](workflows-working-runs.md).
Como el flujo de trabajo de publicación denominado `blueprint-release` se crea mediante un esquema, este se puede encontrar como un esquema aplicado en el proyecto. Para obtener más información, consulte [Incorporación de un esquema a un proyecto para integrar recursos](apply-bp.md) y [Desasociación de un esquema en un proyecto para detener las actualizacionesDesasociación de un esquema en un proyecto](disassociate-bp.md).
## Paso 2: desarrollo de un esquema personalizado con componentes
Al crear un esquema personalizado, se genera un asistente de esquemas, que se puede modificar con componentes al desarrollar el esquema personalizado. Puede actualizar los archivos `src/blueprints.js` y `src/defaults.json` para modificar el asistente.
**importante**
Si desea utilizar paquetes de esquemas de código fuente externo, tenga en cuenta los riesgos que podrían conllevar dichos paquetes. Los esquemas personalizados que añada en su espacio, así como el código que generen, quedan bajo su responsabilidad.
Cree un entorno de desarrollo en el proyecto de CodeCatalyst con un entorno de desarrollo integrado (IDE) compatible antes de configurar el código del esquema. Se necesita un entorno de desarrollo para trabajar con las herramientas y los paquetes necesarios.
**Creación de un entorno de desarrollo**
1. En el panel de navegación, lleve a cabo alguna de las siguientes acciones:
1. Seleccione **Descripción general** y vaya a la sección **Mis entornos de desarrollo**.
1. Seleccione **Código** y **Entornos de desarrollo**.
1. Seleccione **Código** y **Repositorios de origen** y elija el repositorio que creó al crear el esquema.
1. Seleccione **Crear entorno de desarrollo**.
1. Seleccione un IDE compatible desde el menú desplegable. Consulte [Supported integrated development environments for Dev Environments](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-create.html#devenvironment-supported-ide) para obtener más información.
1. Seleccione **Trabajar en una ramificación existente** y, en el menú desplegable **Ramificación existente**, seleccione la ramificación de características que ha creado.
1. (Opcional) En el campo de entrada de texto **Alias: *opcional***, introduzca un alias para identificar el entorno de desarrollo.
1. Seleccione **Crear**. Mientras se crea el entorno de desarrollo, la columna de estado del entorno de desarrollo mostrará **Iniciándose**, y la columna de estado mostrará **En ejecución** una vez se haya creado el entorno de desarrollo.
Para obtener más información, consulte [Escribe y modifica código con entornos de desarrollo en CodeCatalystCreación y modificación de código con entornos de desarrollo](devenvironment.md).
**Desarrollo del esquema personalizado**
1. En un terminal que funcione, utilice el siguiente comando de `yarn` para instalar las dependencias:
```
yarn
```
Las herramientas y los paquetes necesarios están disponibles a través del entorno de desarrollo de CodeCatalyst, lo que incluye Yarn. Si está trabajando en un esquema personalizado sin un entorno de desarrollo, instale primero Yarn en el sistema. Para obtener más información, consulte la [documentación de instalación de Yarn](https://classic.yarnpkg.com/en/docs/install#mac-stable).
1. Desarrolle el esquema personalizado de modo que esté configurado de acuerdo con sus preferencias. Puede modificar el asistente de esquemas añadiendo componentes. Para obtener más información, consulte [Desarrollo de un esquema personalizado para cumplir los requisitos del proyecto](develop-bp.md), [Modificación de las características del esquema con un asistente de front-end](wizard-bp.md) y [Publicación de un esquema personalizado en un espacio](publish-bp.md).
## Paso 3: obtención de una vista previa de un esquema personalizado
Tras configurar y desarrollar un esquema personalizado, puede previsualizar y publicar la versión preliminar de este en su espacio. Una versión preliminar le permite comprobar si el esquema se corresponde con lo que necesita antes de usarlo para crear nuevos proyectos o antes de aplicarlo a proyectos existentes.
**Vista previa de un esquema personalizado**
1. En un terminal que funcione, use el siguiente comando de `yarn`:
```
yarn blueprint:preview
```
1. Vaya al enlace `See this blueprint at:` proporcionado para obtener una vista previa del esquema personalizado.
1. Compruebe que la interfaz de usuario, lo que incluye el texto, aparezca como esperaba según su configuración. Si desea cambiar el esquema personalizado, puede editar el archivo `blueprint.ts`, volver a sintetizar el esquema y publicar de nuevo una versión preliminar. Para obtener más información, consulte [Resíntesis](custom-bp-concepts.md#resynthesis-concept).
## (Opcional) Paso 4: publicación de una versión preliminar de un esquema personalizado
Puede publicar una versión preliminar del esquema personalizado en su espacio si desea añadirlo al catálogo de esquemas del espacio. Esto le permitirá ver el esquema como usuario antes de añadir la versión no preliminar al catálogo. La versión preliminar le permite publicar sin tener que utilizar una versión real. Por ejemplo, si trabaja en una versión `0.0.1`, 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 `0.0.2`.
**Publicación de la versión preliminar de un esquema personalizado**
Vaya al enlace `Enable version [version number] at:` proporcionado para habilitar el esquema personalizado. Este enlace se proporciona al ejecutar el comando de `yarn` en el [Paso 3: obtención de una vista previa de un esquema personalizado](#getting-started-publish-bp).
Tras crear, desarrollar, previsualizar y publicar el esquema personalizado, podrá publicar la versión final de este y añadirla al catálogo de esquemas del espacio. Para obtener más información, consulte [Publicación de un esquema personalizado en un espacio](publish-bp.md) y [Incorporación de un esquema personalizado a un catálogo de esquemas del espacio](add-bp.md).