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. # Instalación de libros de recetas personalizados **importante** El AWS OpsWorks Stacks servicio llegó al final de su vida útil el 26 de mayo de 2024 y se ha desactivado tanto para los clientes nuevos como para los existentes. Recomendamos encarecidamente a los clientes que migren sus cargas de trabajo a otras soluciones lo antes posible. Si tienes preguntas sobre la migración, ponte en contacto con el AWS Support equipo en [AWS Re:post](https://repost.aws/) o a través de Premium [AWS Support](https://aws.amazon.com/support). Para que una pila instale y utilice libros de recetas personalizados, debe configurar la pila para permitirlos, si no lo está ya. A continuación, debe introducir la URL del repositorio y cualquier información relacionada, por ejemplo, una contraseña. **importante** Una vez que hayas configurado la pila para que admita libros de cocina personalizados, OpsWorks Stacks instalará automáticamente tus libros de cocina en todas las instancias nuevas al inicio. [**Sin embargo, debes indicar explícitamente a OpsWorks Stacks que instale libros de cocina nuevos o actualizados en cualquier instancia existente. Para ello, ejecuta el comando Update Custom Cookbooks stack.**](workingstacks-commands.md) Para obtener más información, consulte [Actualización de libros de recetas personalizados](workingcookbook-installingcustom-enable-update.md). Antes de habilitar **Use custom Chef cookbooks (Usar libros de recetas de Chef personalizados)** en la pila, asegúrese de que los libros de recetas personalizados y de la comunidad que ejecuta son compatibles con la versión de Chef que utiliza la pila. **Para configurar una pila para permitir libros de recetas personalizados** 1. En la página de la pila, haga clic en **Stack Settings (Configuración de pila)** para mostrar la página **Settings (Configuración)** y, a continuación, haga clic en **Edit (Editar)** para editar la configuración. 1. Establezca **Use custom Chef cookbooks (Usar libros de recetas de Chef personalizados)** en **Yes (Sí)**. ![\[Página de edición de la configuración de la pila\]](http://docs.aws.amazon.com/es_es/opsworks/latest/userguide/images/stack_settings_edit.png) 1. Configurar libros de recetas personalizados. Cuando haya terminado, haga clic en **Save (Guardar)** para guardar la pila actualizada. ## Especificación de un repositorio de libros de recetas personalizados Las pilas de Linux instalan libros de recetas personalizados de cualquiera de los siguientes tipos de repositorios: + Archivos HTTP o Amazon S3. Aunque pueden ser públicos o privados, Amazon S3 suele ser la opción preferida en el caso de los archivos de almacenamiento privados. + Los repositorios Git y Subversion permiten controlar los orígenes y tener varias versiones. Las pilas de Windows pueden instalar libros de recetas personalizados de archivos de almacenamiento de Amazon S3 y de repositorios Git. Todos los tipos de repositorio tienen los siguientes campos obligatorios. + **Tipo de repositorio**: el tipo de repositorio + **Repository URL**: la URL del repositorio OpsWorks Stacks admite sitios de repositorios Git alojados públicamente, como [GitHub](https://github.com/)[Bitbucket](https://bitbucket.org), así como servidores Git alojados de forma privada. En el caso de los repositorios Git, utilice uno de los siguientes formatos de URL; esto dependerá de si el repositorio es público o privado. Siga las mismas directrices URL en los submódulos Git. En el caso de un repositorio Git público, utilice los protocolos HTTPS o Git de solo lectura: + Git de solo lectura: `git://github.com/amazonwebservices/opsworks-example-cookbooks.git` + HTTPS – `https://github.com/amazonwebservices/opsworks-example-cookbooks.git`. Para un repositorio Git privado, debes usar el read/write formato SSH, como se muestra en los siguientes ejemplos: + Repositorios de Github: `git@github.com:project/repository`. + Repositorios en un servidor Git: `user@server:project/repository` Las demás opciones de configuración varían en función del tipo de repositorio y se describen en las siguientes secciones. ### Archivo HTTP Al seleccionar **Http Archive (Archivo Http)** en **Repository type (Tipo de repositorio)**, se muestran dos opciones de configuración adicionales que debe completar si el archivo de almacenamiento está protegido con contraseña. + **Nombre de usuario**: su nombre de usuario de SMTP. + **Contraseña**: su contraseña ### Archivo de Amazon S3 Al seleccionar **S3 Archive (Archivo de S3)** en **Repository type (Tipo de repositorio)**, se muestran las siguientes opciones de configuración adicionales y opcionales. OpsWorks Stacks puede acceder a tu repositorio mediante los EC2 roles de Amazon (autenticación del administrador del sistema operativo del host), ya sea que utilices la API o la OpsWorks consola de Stacks. + **ID de clave de acceso**: un ID de clave de acceso de AWS, comoAKIAIOSFODNN7EXAMPLE. + **Clave de acceso secreta**: la clave de acceso secreta de AWS correspondiente, por ejemplowJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY. ### Repositorio Git Si se selecciona **Git** en **Source Control (Control de origen)**, se muestran las siguientes opciones de configuración adicionales (opcionales): **Repository SSH key (Clave SSH del repositorio)** Debe especificar una clave SSH de implementación para obtener acceso a repositorios Git privados. Con los submódulos Git, la clave especificada debe obtener acceso a esos submódulos. Para obtener más información, consulte [Uso de las claves SSH de repositorios Git](workingapps-deploykeys.md). La clave SSH de implementación no puede requerir una contraseña; OpsWorks Stacks no tiene forma de pasarla. **Branch/Revision** Si el repositorio tiene varias sucursales, OpsWorks Stacks descarga la rama maestra de forma predeterminada. Para especificar una rama en particular, ingresa el nombre de la rama, el SHA1 hash o el nombre de la etiqueta. Para especificar una confirmación en concreto, introduzca su ID de 40 dígitos hexadecimales completo. ### Repositorio de Subversion Si se selecciona **Subversion (Subversión)** en **Source Control (Control de origen)**, se muestran las siguientes opciones de configuración adicionales: + **User name**: su nombre de usuario, para los repositorios privados. + **Password**: su contraseña, para los repositorios privados. + **Revisión**: (Opcional) el nombre de la revisión si hubiera varias. Para especificar una ramificación o etiqueta, debe modificar la URL del repositorio, por ejemplo: **http://repository\$1domain/repos/myapp/branches/my-apps-branch** o **http://repository\$1domain\$1name/repos/calc/myapp/my-apps-tag**.