For the complete documentation index, see llms.txt. This page is also available as Markdown.

Análise de chocolatey.log

Esta parte irá focar-se em como resolver problemas de instalações falhadas de pacotes chocolatey.

Requisitos

Os seguintes itens são necessários ou úteis para a resolução de problemas:

  • Arquivos de log, especialmente chocolatey.log.

  • Editor de texto de sua preferência com recursos avançados de pesquisa, recomendado: Notepad++, Visual Studio Code.

  • ID do pacote do pacote com falha, como generic-mozilla-firefox.

  • Carimbo de data e hora das instalações com falha (não obrigatório, mas útil).

Estrutura do arquivo de log

Ponto de entrada e informações de depuração

Para encontrar o ponto de entrada da instalação do pacote dentro do chocolatey.log use esta cadeia de pesquisa exata (adapte o id do pacote conforme necessário): generic-mozilla-firefox --version= (se você tiver certeza da string de versão, é claro que pode adicioná-la, mas não é obrigatório)

Dessa forma, você encontrará o(s) ponto(s) de início do processo do choco para a instalação ou atualização do ID de pacote informado.

A linha completa no log pode se parecer com isto, em vez de atualização também pode ser instalação dependendo da operação:

2023-08-22 15:05:36,664 [DEBUG] - Command line: "C:\ProgramData\chocolatey\choco.exe" upgrade generic-mozilla-firefox --version=117.0.0.0 --force --yes --ignore-package-exit-codes --timeout=14400 --params="/BlockAddons:1"
Ponto de entrada de uma instalação do choco dentro de chocolatey.log

Esta linha já contém algumas informações importantes, como o número da versão do pacote a ser instalado, bem como os parâmetros usados (argumentos do pacote configurados no Portal do RealmJoin).

As linhas a seguir conterão muita informação de depuração (não relevante); entre outras coisas, o conteúdo completo de chocolateyInstall.ps1 será exibido. Dentro das informações de depuração, você encontrará as duas seções RJAppDeployToolkit: Input Environment Variables e RJAppDeployToolkit: Resulting Variables. Ambas as seções estão localizadas lado a lado e mostram variáveis e valores fornecidos pelo RJAppDeployToolkit

Saída do RJAppDeployToolkit

Processo de instalação

O script real de instalação do pacote começa após a seguinte mensagem de log:

Dependendo do script de instalação do pacote e do estado do cliente, a primeira etapa geralmente será verificar se o software já está instalado. Isso é feito para determinar se será necessária uma desinstalação antes da instalação real. Nos logs, isso pode ser rastreado usando uma ou mais das seguintes mensagens de log:

Após a execução das verificações e das possíveis desinstalações, a instalação principal do aplicativo será iniciada, indicada pela seguinte mensagem de log (o nome do arquivo, é claro, será diferente):

A instalação geralmente começa com o download do arquivo binário. O início e o fim do download são representados pelas seguintes mensagens de log:

Após concluir o download, o chocolatey verificará o hash do arquivo baixado e o comparará com o valor esperado. Se os hashes corresponderem, o arquivo de instalação será finalmente executado. A mensagem de log da execução pode ser encontrada pela seguinte mensagem de log:

Esta mensagem inclui o caminho do arquivo para o arquivo de instalação, bem como a linha de comando completa, incluindo todos os parâmetros (silenciosos) usados para iniciar o arquivo de instalação. Ela também ajudará a encontrar o caminho relevante do arquivo de log da instalação, se ele for fornecido pelo arquivo de instalação e incluído no script do pacote.

Após o processo ser encerrado, outra mensagem de log será gravada, novamente incluindo o caminho completo do arquivo e todos os parâmetros. Além disso, essa mensagem também incluirá o código de saída retornado pelo processo de instalação, o indicador mais importante de uma instalação bem-sucedida ou malsucedida:

Dependendo do pacote, a instalação do pacote pode agora ser seguida pelas chamadas 'postActions', que podem ser algumas configurações do registro, remoção de ícones da área de trabalho ou até mesmo a execução de outro arquivo de instalação (recomeçando com o download desse arquivo). A parte de postActions será indicada pelas seguintes mensagens de início e fim no arquivo de log:

O processo de instalação do chocolatey será encerrado com a seguinte mensagem de log (a redação pode variar dependendo de instalação / atualização):

Última atualização

Isto foi útil?