> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/es/agente-de-realmjoin/realmjoin-client/native-choco-runtime.md).

# Native Choco Runtime

Native Choco Runtime es el propio motor de instalación de paquetes en proceso de RealmJoin, que reemplaza al binario obsoleto Chocolatey 0.10.3 manteniendo plena compatibilidad con los paquetes existentes.

{% hint style="info" %}
El Native Choco Runtime se introdujo con **RealmJoin Agent 4.21.6 (Beta)**. La funcionalidad es **opcional**: los clientes existentes siguen usando el motor clásico de Chocolatey hasta que habilites explícitamente el runtime nativo.
{% endhint %}

## Qué es

Cuando el RealmJoin Agent instala paquetes de software fuera de Intune (consulta [instalación de paquetes](https://docs.realmjoin.com/es/agente-de-realmjoin/realmjoin-client/deploy-apps.md#package-installation)), tradicionalmente ha dependido de [Chocolatey](https://chocolatey.org/) como motor subyacente de paquetes. RealmJoin distribuyó una compilación fijada y muy parcheada de la CLI de Chocolatey de código abierto — versión **0.10.3** — incluida como `choco.exe` bajo `C:\ProgramData\chocolatey\`.

Los **Native Choco Runtime** reemplaza ese binario de Chocolatey incluido por la **propia implementación creada específicamente para este fin** que se ejecuta **en proceso** dentro del servicio RealmJoin. Además *simula* Chocolatey: entiende el mismo formato de paquete (`.nupkg`) y se comporta igual desde el punto de vista del autor del paquete y del administrador, pero ya no depende de la envejecida base de código de Chocolatey 0.10.3.

En otras palabras, los paquetes que ya usas siguen funcionando sin cambios; solo cambia el motor que está debajo.

## Cómo funciona

* **Motor en proceso.** Las instalaciones de paquetes se ejecutan dentro del servicio RealmJoin en lugar de invocar un `choco.exe`. El `chocolateyInstall.ps1` externo; el contenido de cada paquete se ejecuta en un espacio de ejecución de PowerShell en proceso.
* **Almacenamiento aislado.** El runtime nativo se instala en su **propio** raíz, `C:\ProgramData\RealmJoin\choco\` (con subcarpetas `lib\`, `extensions\`, y `logs\` ). Nunca escribe en el estado del Chocolatey clásico en `C:\ProgramData\chocolatey\` y nunca cambia la variable de entorno de todo el sistema `ChocolateyInstall` . Esto significa que el runtime nativo y un Chocolatey clásico ya existente pueden **coexistir** en el mismo dispositivo.
* **Resolución automática de dependencias.** Las dependencias de paquete declaradas en el `.nuspec` (como el [RealmJoin Core Choco Extension](https://docs.realmjoin.com/es/agente-de-realmjoin/recommended-packages.md#realmjoin-core-choco-extension)) se resuelven e instalan automáticamente desde tus orígenes configurados.
* **`choco.exe` shim.** Algunos scripts de paquetes llaman `choco.exe` directamente. Para que sigan funcionando, el runtime implementa un pequeño shim en `%ProgramFiles%\RealmJoin\choco-shim\choco.exe` que redirige esas llamadas de vuelta al motor en proceso en lugar de a Chocolatey clásico. El shim no se agrega al `PATH`del sistema; solo se pone a disposición de los scripts de paquetes mientras se ejecutan.

## Compatibilidad

El Native Choco Runtime está diseñado como un **reemplazo directo**:

* Los paquetes existentes de RealmJoin (incluido todo lo de [Package Store](https://docs.realmjoin.com/es/administracion-de-aplicaciones/packages/package-store.md)) se instalan y desinstalan de la misma manera.
* Los argumentos / params de los paquetes configurados en el RealmJoin Portal siguen funcionando.
* Los [RealmJoin Core Choco Extension](https://docs.realmjoin.com/es/agente-de-realmjoin/recommended-packages.md#realmjoin-core-choco-extension) los cmdlets auxiliares usados dentro de los scripts de paquetes siguen estando disponibles.
* [ESP de RealmJoin](https://docs.realmjoin.com/es/agente-de-realmjoin/realmjoin-client/realmjoin-esp.md) / Autopilot son compatibles: en un dispositivo nuevo con el runtime nativo habilitado, `winchoco` los paquetes se instalan de forma nativa durante el registro, con sus dependencias resueltas automáticamente.

{% hint style="warning" %}
Como este runtime está en beta, recomendamos validar tus paquetes más importantes en un anillo piloto antes de desplegarlo a todo el tenant. Informa cualquier diferencia de comportamiento al Soporte de RealmJoin para que podamos corregirla antes de la disponibilidad general.
{% endhint %}

## Cómo usarlo

El runtime se selecciona mediante una **configuración de RealmJoin**, por lo que puedes controlarlo de forma centralizada en lugar de tocar clientes individuales. Las configuraciones de RealmJoin son acumulativas, lo que significa que puedes establecer un **valor predeterminado para todo el tenant** y, cuando sea necesario, **anularlo para grupos específicos** (y los objetos dentro de ellos).

{% hint style="info" %}
Clave de configuración: `Chocolatey.UseNativeRuntime`

Valor de configuración: `true` / `falso`
{% endhint %}

Las siguientes configuraciones controlan el comportamiento:

<table><thead><tr><th>Ajuste</th><th width="120">Predeterminado</th><th>Significado</th></tr></thead><tbody><tr><td><code>Chocolatey.Enabled</code></td><td><code>falso</code></td><td>RealmJoin administra paquetes de tipo Chocolatey en el dispositivo.</td></tr><tr><td><code>Chocolatey.UseNativeRuntime</code></td><td><code>falso</code></td><td>Interruptor maestro. Cuando <code>falso</code>, las instalaciones siguen pasando por el <code>choco.exe</code>. Cuando <code>true</code>clásico <code>winchoco</code> , todas las instalaciones pasan por el runtime nativo en proceso.</td></tr><tr><td><code>Chocolatey.DisableShim</code></td><td><code>falso</code></td><td>Solo relevante cuando <code>UseNativeRuntime = true</code>. Cuando <code>true</code>, cualquier script de paquete que llame a un <code>choco.exe</code> falla de forma explícita en lugar de ser redirigido a través del shim; útil para identificar scripts que aún recurren a un binario externo.</td></tr></tbody></table>

{% stepper %}
{% step %}

### Habilítalo primero para un grupo piloto

Abre la configuración de un **grupo** de RealmJoin que contenga un pequeño conjunto de dispositivos piloto y establece `Chocolatey.UseNativeRuntime` a `true` allí. Como la configuración de grupo tiene prioridad sobre el valor predeterminado de todo el tenant, solo esos dispositivos cambian al nuevo motor.
{% endstep %}

{% step %}

### Valida tus paquetes

Deja que los dispositivos piloto ejecuten sus asignaciones y actualizaciones de paquetes normales. Confirma que las instalaciones se completan correctamente y revisa los registros si algo parece incorrecto (consulta [Problemas de instalación de paquetes](https://docs.realmjoin.com/es/solucion-de-problemas-y-preguntas-frecuentes/troubleshooting/package-installation-issues.md)).
{% endstep %}

{% step %}

### Desplégalo a todo el tenant

Una vez que estés seguro, establece `Chocolatey.UseNativeRuntime` a `true` ya que la **valor predeterminado para todo el tenant** para que todos los clientes lo usen. Los grupos individuales aún pueden excluirse si necesitas mantenerlos temporalmente en el motor clásico.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
La configuración sigue el mismo modelo de configuración de tenant / anulación por grupo que los demás ajustes del agente descritos en [Configuraciones generales](https://docs.realmjoin.com/es/administracion-y-configuracion/general.md) (por ejemplo, la **Configuración del cliente** y **Configuración de LAPS** configuración del Tenant).
{% endhint %}

## Cuál es el valor predeterminado

Native Choco Runtime **está deshabilitado de forma predeterminada** (`Chocolatey.UseNativeRuntime = false`). Los clientes siguen usando el motor clásico incluido de Chocolatey 0.10.3 hasta que un administrador habilita el runtime nativo, ya sea para todo el tenant o para un grupo específico. Esto te permite adoptar el nuevo runtime a tu propio ritmo y revertirlo con la misma facilidad mientras la funcionalidad esté en beta.

## Migración de dispositivos existentes

El runtime nativo y Chocolatey clásico **coexistir** en un dispositivo durante el tiempo que sea necesario. Cuando habilitas el runtime nativo en un dispositivo que ya tiene paquetes instalados con Chocolatey clásico:

* Los paquetes existentes administrados por RealmJoin siguen funcionando y **no** no se reinstalan solo porque cambió el runtime; su estado instalado se conserva durante el cambio, así que no hay una avalancha de reinstalaciones.
* Las nuevas instalaciones y actualizaciones pasan por el runtime nativo; la instalación clásica permanece en disco, sin tocar, hasta que se elimine explícitamente.

{% hint style="info" %}
La eliminación de Chocolatey clásico en toda la flota está prevista como un paso separado y orquestado. Hasta entonces, el runtime nativo puede coexistir sin problema con una instalación clásica residual, así que no hay una fecha límite estricta para limpiarla.
{% endhint %}

Para un dispositivo individual (por ejemplo, durante soporte o QA), un administrador puede sacar una máquina de Chocolatey clásico con el `migre` verbo **elevado** shell:

{% code overflow="wrap" %}

```powershell
# Previsualiza lo que ocurriría, sin hacer cambios
& "C:\Program Files\RealmJoin\choco-shim\choco.exe" migrate --dry-run

# Reinstala los paquetes con estado mediante el runtime nativo y luego elimina el clásico
& "C:\Program Files\RealmJoin\choco-shim\choco.exe" migrate --yes
```

{% endcode %}

{% hint style="warning" %}
`choco migrate` es un **ayudante de administración para un solo dispositivo** (soporte, dev/QA, limpieza puntual). **no** No es el mecanismo para desplegar el cambio en toda la flota; para eso usa la configuración de tenant/grupo.
{% endhint %}

## Registros y solución de problemas

Las instalaciones del runtime nativo escriben un registro por paquete en:

```
C:\ProgramData\RealmJoin\choco\logs\<package-id>\<timestamp>_<version>_<operation>.log
```

(se conservan las 10 entradas más recientes por paquete). Esto es independiente de los `C:\ProgramData\chocolatey\logs\`clásicos de Chocolatey. Al recopilar registros para una solicitud de soporte, incluye la carpeta `C:\ProgramData\RealmJoin\` tal como se describe en [Problemas de instalación de paquetes](https://docs.realmjoin.com/es/solucion-de-problemas-y-preguntas-frecuentes/troubleshooting/package-installation-issues.md).

### Referencia de archivos y rutas

| Ruta                                              | Propósito                                                    |
| ------------------------------------------------- | ------------------------------------------------------------ |
| `C:\ProgramData\RealmJoin\choco\lib\<id>`         | Raíz de instalación de paquetes del runtime nativo.          |
| `C:\ProgramData\RealmJoin\choco\extensions\<id>`  | Módulos auxiliares de PowerShell importados automáticamente. |
| `C:\ProgramData\RealmJoin\choco\logs\<id>`        | Registros por instalación (los 10 últimos por paquete).      |
| `C:\Program Files\RealmJoin\choco-shim\choco.exe` | Los `choco.exe` shim.                                        |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/es/agente-de-realmjoin/realmjoin-client/native-choco-runtime.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
