Native Choco Runtime
A Native Choco Runtime é o próprio motor de instalação de pacotes no processo do RealmJoin que substitui o binário desatualizado Chocolatey 0.10.3, mantendo-se totalmente compatível com os pacotes existentes.
O que é
Quando o RealmJoin Agent instala pacotes de software fora do Intune (veja instalação de pacotes), ele tradicionalmente dependia de Chocolatey como o mecanismo subjacente de pacotes. O RealmJoin fornecia uma versão fixa e fortemente modificada da CLI Chocolatey de código aberto — versão 0.10.3 — distribuída como choco.exe ao abrigo de C:\ProgramData\chocolatey\.
O Native Choco Runtime substitui esse binário Chocolatey incluído pela implementação própria, desenvolvida especificamente para esse fim que é executada no próprio processo dentro do serviço do RealmJoin. Ela emula Chocolatey: ele entende o mesmo formato de pacote (.nupkg) e se comporta da mesma forma do ponto de vista do autor do pacote e do administrador, mas já não depende da antiga base de código Chocolatey 0.10.3.
Em outras palavras, os pacotes que você já usa continuam funcionando sem alterações — apenas o mecanismo subjacente muda.
Como funciona
Mecanismo no próprio processo. As instalações de pacotes são executadas dentro do serviço do RealmJoin em vez de chamar um script externo
choco.exe. OchocolateyInstall.ps1de cada pacote é executado em um espaço de execução do PowerShell no próprio processo.Armazenamento isolado. O runtime nativo instala-se em seu próprio raiz,
C:\ProgramData\RealmJoin\choco\(comlib\,extensions\elogs\subpastas). Ele nunca grava no estado do Chocolatey clássico emC:\ProgramData\chocolatey\e nunca altera a variável de ambiente em nível de máquinaChocolateyInstall. Isso significa que o runtime nativo e um Chocolatey clássico já existente podem coexistir no mesmo dispositivo.Resolução automática de dependências. As dependências do pacote declaradas no
.nuspec(como o RealmJoin Core Choco Extension) são resolvidas e instaladas automaticamente a partir das suas origens configuradas.choco.exeshim. Alguns scripts de pacote chamamchoco.exediretamente. Para mantê-los funcionando, o runtime implanta um pequeno shim para%ProgramFiles%\RealmJoin\choco-shim\choco.exeque redireciona essas chamadas de volta para o mecanismo em processo em vez de para o Chocolatey clássico. O shim não é adicionado ao sistemaPATH; ele só é disponibilizado aos scripts de pacote enquanto são executados.
Compatibilidade
O Native Choco Runtime foi projetado como um substituto pronto para uso:
Os pacotes existentes do RealmJoin (incluindo tudo do Package Store) são instalados e desinstalados da mesma forma.
Os argumentos / parâmetros de pacote configurados no RealmJoin Portal continuam funcionando.
O RealmJoin Core Choco Extension os cmdlets auxiliares usados dentro dos scripts de pacote continuam disponíveis.
ESP do RealmJoin / Autopilot são suportados: em um dispositivo novo com o runtime nativo habilitado,
winchocoos pacotes são instalados nativamente durante o registro, com suas dependências resolvidas automaticamente.
Como usá-lo
O runtime é selecionado por meio de uma configuração, então você pode controlá-lo centralmente em vez de tocar em clientes individuais. As configurações do RealmJoin são herdadas em cascata, o que significa que você pode definir uma padrão em todo o tenant e, quando necessário, substituí-lo para grupos específicos (e os objetos dentro deles).
As seguintes configurações controlam o comportamento:
Chocolatey.Enabled
falso
O RealmJoin gerencia pacotes do tipo Chocolatey no dispositivo.
Chocolatey.UseNativeRuntime
falso
Interruptor principal. Quando falso, as instalações ainda passam pelo Chocolatey clássico choco.exe. Quando verdadeiro, todas winchoco as instalações passam pelo runtime nativo em processo.
Chocolatey.DisableShim
falso
Relevante apenas quando UseNativeRuntime = true. Quando verdadeiro, qualquer script de pacote que chame um binário externo choco.exe falha de forma explícita em vez de ser encaminhado pelo shim — útil para revelar scripts que ainda dependem de um binário externo.
Habilite-o primeiro para um grupo piloto
Abra as configurações de um grupo que contenha um pequeno conjunto de dispositivos piloto e defina Chocolatey.UseNativeRuntime a verdadeiro a configuração lá. Como as configurações de grupo têm precedência sobre o padrão em todo o tenant, apenas esses dispositivos mudam para o novo mecanismo.
Valide seus pacotes
Deixe os dispositivos piloto executarem suas atribuições e atualizações normais de pacotes. Confirme que as instalações sejam bem-sucedidas e verifique os logs se algo parecer errado (veja Problemas de instalação de pacotes).
Qual é o padrão
O Native Choco Runtime está desabilitado por padrão (Chocolatey.UseNativeRuntime = false). Os clientes continuam usando o mecanismo clássico Chocolatey 0.10.3 empacotado até que um administrador habilite o runtime nativo — seja em todo o tenant ou para um grupo específico. Isso permite adotar o novo runtime no seu próprio ritmo e revertê-lo com a mesma facilidade enquanto o recurso está em beta.
Migrando dispositivos existentes
O runtime nativo e o Chocolatey clássico coexistir em um dispositivo pelo tempo necessário. Quando você habilita o runtime nativo em um dispositivo que já possui pacotes instalados pelo Chocolatey clássico:
Os pacotes existentes gerenciados pelo RealmJoin continuam funcionando e são não reinstalados apenas porque o runtime mudou — o estado instalado é mantido na mudança, portanto não há enxurrada de reinstalações.
Novas instalações e atualizações passam pelo runtime nativo; a instalação clássica permanece no disco, intocada, até ser removida explicitamente.
Para um dispositivo individual (por exemplo, durante suporte ou QA), um administrador pode retirar uma máquina do Chocolatey clássico com o verbo do shim migre a partir de um com privilégios elevados terminal:
Logs e solução de problemas
As instalações do runtime nativo gravam um log por pacote em:
(mantido para as 10 entradas mais recentes por pacote). Isso é separado do C:\ProgramData\chocolatey\logs\. Ao coletar logs para uma solicitação de suporte, inclua a C:\ProgramData\RealmJoin\ pasta conforme descrito em Problemas de instalação de pacotes.
Referência de arquivo e caminho
C:\ProgramData\RealmJoin\choco\lib\<id>
Raiz de instalação de pacotes do runtime nativo.
C:\ProgramData\RealmJoin\choco\extensions\<id>
Módulos auxiliares do PowerShell importados automaticamente.
C:\ProgramData\RealmJoin\choco\logs\<id>
Logs por instalação (últimos 10 por pacote).
C:\Program Files\RealmJoin\choco-shim\choco.exe
O choco.exe shim.
Última atualização
Isto foi útil?