> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/automate-protect-and-extend/es/automatizacion/recipes-organization.md).

# Organización de recetas

Esta página trata sobre repositorios y catálogos, los contenedores utilizados para organizar recetas de inquilinos y de VM. También se incluyen instrucciones para compartir recetas.

## Repositorios

### ¿Qué es un repositorio?

Un repositorio es una colección de recetas del sitio. Un repositorio puede contener varios catálogos de recetas.

```mermaid
graph TD
    A["Repositorio"] --> B("Catálogo 1")
    A --> C("Catálogo 2")
    A --> D("Catálogo 3")
    B --> E("Receta de VM")
    B --> F("Receta de VM")
    C --> G("Receta de inquilino")
    C --> H("Receta de inquilino")
    D --> I("Receta de VM")
    D --> J("Receta de inquilino")
    D --> K("Receta de VM")
```

* **Repositorios locales**: los catálogos/recetas se crean y mantienen en el sistema local.
* **Repositorios remotos**: los catálogos de recetas, creados y mantenidos en un sistema VergeOS separado, se recuperan para su uso en el sistema local. Compartir mediante repositorios remotos elimina la necesidad de administrar las mismas recetas en múltiples ubicaciones.

### Repositorios instalados automáticamente

***"MarketPlace"***\
Los sistemas a nivel de host se instalan con ***Marketplace***, un repositorio especial, remoto, proporcionado por VergeOS que incluye una amplia variedad de recetas de VM de Linux y Windows listas para usar. De forma predeterminada, los catálogos de recetas contenidos en Marketplace se establecen con scope="global", lo que también les permite ser utilizados por todos los inquilinos del sistema.

***"Local"***\
De forma predeterminada, su nuevo sistema VergeOS tendrá un repositorio local vacío llamado ***"Local"*** que está listo para crear nuevos catálogos/recetas.

## Catálogos

### ¿Qué es un catálogo?

Los catálogos le permiten agrupar sus recetas relacionadas dentro de un repositorio. Por ejemplo, un catálogo puede contener varias recetas de VM de Windows, mientras que otro contiene todas las recetas de VM basadas en Linux. Los administradores pueden usar los catálogos para organizarlos de la manera que tenga más sentido para su organización. Los catálogos se pueden configurar como privados o compartidos con sus inquilinos u otros sistemas VergeOS externos.

### Crear un nuevo catálogo

1. Vaya a **Repositorios** > **Lista** del menú superior, y **haga doble clic en el repositorio** donde debe residir el catálogo. Esto deberá ser un repositorio local; los repositorios remotos se mantienen en el sistema remoto. (Normalmente se usaría el repositorio predeterminado *"Local"* creado en cada nuevo sistema/inquilino VergeOS.)
2. Haga clic en **Catálogos** en el menú de la izquierda y luego haga clic en **Nuevo**.
3. Proporcione una **Nombre** descriptiva para el catálogo. Opcionalmente, se puede añadir información administrativa adicional en el campo de descripción.
4. Seleccione un **Ámbito de publicación** para definir la accesibilidad del catálogo:
   * **Privado** - solo disponible para esta nube VergeOS en particular.
   * **Ninguno** - deshabilitado, no disponible en ninguna parte
   * **Inquilino** - disponible para esta nube en particular y sus propios inquilinos
   * **Global** - disponible para este sistema en particular y sus inquilinos y sistemas VergeOS externos (se requieren credenciales de usuario)

## Compartir recetas

### Compartir catálogos con sus inquilinos

1. Configure el **Ámbito de publicación =** ***'Inquilinos'*** (o 'Global', lo que también permitirá el acceso a sistemas externos usando las credenciales adecuadas).
2. **Cambie a la interfaz de usuario del inquilino** para el resto de los pasos.
3. Navegue hasta la ***Proveedor de servicios*** repositorio y haga clic en **Actualizar**.
4. **Haga doble clic en el catálogo deseado** para ver las recetas contenidas en él.
5. Haga clic en **Recetas de VM** -o- **Recetas de inquilino** para ver el listado correspondiente.
6. **Seleccione la(s) receta(s) deseada(s).**
7. Haga clic en **Descargar/Actualizar** en el menú de la izquierda para descargar al entorno del inquilino. Cuando una receta muestra un estado de *En línea* está disponible para su uso.

{% hint style="info" %}
**Cuando una receta se actualiza en el origen, mostrará un mensaje en la interfaz de usuario del inquilino indicando que hay una actualización disponible para descargar.**
{% endhint %}

### Compartir catálogos con un sistema remoto

**Dar acceso a un catálogo (lado que comparte)**

1. Cree un **usuario nuevo, con Tipo: API** para ser utilizado para la autenticación por el sistema/inquilino remoto. Anote el nombre de usuario y la contraseña.
2. Navegue hasta la **Panel del catálogo** (Repositorios > Catálogos > haga doble clic en el catálogo deseado).
3. Haga clic en **Permisos** en el menú de la izquierda.
4. Haga clic en **Agregar usuario** en el menú de la izquierda.
5. Establezca los siguientes campos para el nuevo permiso:
   * **Beneficiario**: el usuario API creado arriba
   * **Permisos:** Listar y leer
   * **Tipo:** Catálogos
   * **Nombre:** nombre del catálogo que se está compartiendo
6. Haga clic en **Enviar** para guardar el nuevo permiso.

**Conectarse a un catálogo remoto (lado receptor):**

1. Vaya a **Repositorios** > **+ Nuevo repositorio**.
2. Complete **los campos** para el nuevo repositorio:
   * **Nombre**: un nombre descriptivo que ayude a distinguir este repositorio.
   * **Descripción**: (opcional) la información adicional introducida aquí puede ser útil para la administración futura.
   * **Tipo**: Remoto
   * **URL**: la IP o entrada DNS del sistema anfitrión, por ejemplo `https://VergeOS.example.com`
   * **Usuario/Contraseña**: use las credenciales del usuario API creado en el sistema anfitrión (arriba).
   * **Permitir certificados inseguros**: esta opción se proporciona para admitir un certificado autofirmado dentro de la misma red privada; usar una URL pública sin SSL seguro puede ser arriesgado y no se recomienda.
   * **Tier más rápido máximo**: le permite especificar el mejor nivel para usar en las unidades de las recetas (p. ej., si una receta tiene una unidad en el nivel 2 en el sistema remoto, si esta configuración se establece en el nivel 4, la unidad se moverá al nivel 4 cuando se descargue).
3. Haga clic en **Enviar** para guardar el nuevo repositorio.
4. Una vez creado, navegue al **panel del repositorio** y haga clic en **Actualizar** para volver a cargar sus catálogos. Las recetas se pueden descargar localmente y luego estarán disponibles para su uso al crear una nueva VM/inquilino.

{% hint style="info" %}
**Cuando el sistema remoto crea el repositorio que se conecta a su sistema, tendrá acceso a cualquiera de sus catálogos para los que el usuario API dado tenga permisos.**
{% endhint %}

{% hint style="info" %}
**Cuando una receta se actualiza en el origen, mostrará un mensaje en la interfaz de usuario del sistema remoto indicando que hay una actualización disponible para descargar.**
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/automate-protect-and-extend/es/automatizacion/recipes-organization.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.