> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecotrust.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Implementar um patch do catálogo

> Como implementar um patch do catálogo no AutoPatch: escolher o CONNECT, selecionar um ativo que precisa da correção, revisar a aplicação, verificar o resultado e entender quando um ativo ocupado pode receber o patch.

Use este guia para aplicar um patch do catálogo em um ativo que precisa dele e verificar o resultado. Ao final, você terá escolhido o ambiente, revisado o ativo com demanda e acompanhado o que aconteceu nele.

## Pré-requisitos

* Acesso ao painel com o módulo AutoPatch, com o perfil **Gestor** ou **Analista avançado**. Os demais perfis não executam serviços do agente.
* Um patch não arquivado no [Catálogo de patches](https://docs.ecotrust.io/modulos/autopatch/conferir-o-catalogo.md).
* Um CONNECT disponível no ambiente do ativo que precisa do patch.

## Passos

**1. Abrir a implementação**

Abra o **Catálogo de patches**, escolha o patch e clique em **Implementar patch**. Você também pode iniciar pela ficha do produto, em **Pedir ao agente sobre este produto**, ou pela página do produto, na linha **Patch** de **Correção**, em **Pedir ao agente sobre o patch**. O serviço abre com o patch já escolhido.

![Ficha de um patch do catálogo na coluna da direita, com o que ele faz no ativo, o rollback e o botão Implementar patch.](https://mintcdn.com/eco-trust/XmF9HMAIWU97KiZk/images/autopatch/implementar-um-patch-implementar-patch.png?fit=max\&auto=format\&n=XmF9HMAIWU97KiZk\&q=85\&s=00a6a17bce46bbd823a10ee778545b6b)

O botão fica no fim da ficha do patch. Ambiente de exemplo.

**2. Escolher o CONNECT**

Escolha o CONNECT de um ambiente onde o software vulnerável está instalado. O serviço mostra apenas os ativos desse ambiente que ainda precisam do patch. Se não houver demanda nele, escolha um dos ambientes informados pelo serviço.

**3. Selecionar o ativo e a credencial**

Selecione um ativo em que você quer aplicar o patch e informe a credencial solicitada para o acesso. A aplicação pontual aceita um ativo por vez. Para dois ou mais ativos, monte uma campanha com piloto pelo pedido **Montar campanha**, na [ficha do produto](https://docs.ecotrust.io/modulos/autopatch/ler-a-ficha-de-um-produto.md). Esse pedido só aparece depois que o patch está verificado, o que a primeira aplicação pontual bem-sucedida faz, e enquanto o produto não tem campanha aberta. Para ajustar uma preferência do macOS, use uma credencial SSH de um usuário com sudo. Não é preciso usar o login `root`. Em ativos Windows, a atualização pode alcançar somente a versão mais nova compatível com o tipo de instalador atual. Revise a seleção antes de continuar.

**4. Confirmar a aplicação**

Confira o patch e o ativo selecionado e confirme a execução. Em ativos macOS, a prévia também informa as dependências que o Homebrew instalará e avisa quando ele precisar compilar algum pacote do código-fonte. Planeje uma janela em que o ativo possa ficar ocupado se houver esse aviso.

Se a prévia indicar que o Homebrew oferece uma versão mais antiga que a já instalada, o AutoPatch bloqueia essa aplicação para não rebaixar o software.

O AutoPatch aplica o patch e verifica o resultado no ativo. Quando o patch instala dependências adicionais, o rollback também as remove.

## Verificar o resultado

O resumo informa se a aplicação foi concluída no ativo escolhido ou se ele precisa de atenção. Quando uma observação da leitura ainda vale depois da aplicação, ele a mostra em **Observações da leitura feita antes da aplicação**. Por exemplo, a versão mais nova de um software pode exigir outro tipo de instalador e a reinstalação fora do patch. A seção mostra até dez observações e informa quantas ficaram de fora desse limite.

Na página do produto, a aplicação entra na linha **Pontual** de **Correção** e em **Histórico de correções**, com a origem **aplicação pontual**, e o produto fica em **Em correção · aplicando** enquanto restam ativos com demanda. Na linha do ativo, **Rollback** aparece quando a aplicação pode ser desfeita; senão, a linha diz por que não há o que desfazer. Quando o ativo já estava na versão mais recente disponível, o resultado é **Indeterminado**, com esse motivo. Veja [Acompanhar a aplicação de um patch](https://docs.ecotrust.io/modulos/autopatch/acompanhar-a-aplicacao.md).

Quando a aplicação verifica o patch em uma família do sistema, o catálogo registra essa verificação. Uma falha posterior não remove uma verificação já concluída.

## Problemas comuns

> [accordion] Não há ativos para selecionar
>
> O ambiente escolhido não tem ativos que precisem desse patch. Escolha outro CONNECT entre os ambientes informados pelo serviço.

> [accordion] O patch não aparece para implementar
>
> Patches arquivados não podem ser implementados. Abra outro patch ativo no catálogo.

> [accordion] A aplicação de uma preferência do macOS foi bloqueada
>
> Use uma credencial SSH de um usuário que tenha sudo no ativo. Sem essa permissão, o AutoPatch bloqueia a aplicação antes da confirmação.

> [accordion] Um ativo está ocupado por outra correção
>
> O AutoPatch verifica a correção anterior antes de preparar a aplicação. Se ela já terminou, o ativo fica disponível nesta verificação. Se ainda estiver ocupado, a mensagem informa se a correção segue em execução, se o gerenciador de pacotes está trabalhando ou se o CONNECT não respondeu. Aguarde a situação indicada e prepare a correção novamente. Acione o suporte somente quando a mensagem disser que não há outra forma de encerrar a execução anterior.

> [accordion] Um ativo ficou de fora antes da aplicação
>
> Quando o acesso inicial fica parado esperando uma resposta, o AutoPatch deixa o ativo de fora antes de aplicar o patch. Confira se a credencial acessa o ativo sem perguntas interativas, como troca obrigatória de senha ou segundo fator, e se o acesso responde. Depois, prepare a aplicação novamente.

## Próximos passos

* [Acompanhar a aplicação de um patch](https://docs.ecotrust.io/modulos/autopatch/acompanhar-a-aplicacao.md): conferir a mobilização e o resultado por ativo.
* [Verificação de patch por família do sistema](https://docs.ecotrust.io/modulos/autopatch/verificacao-por-familia.md): entender como o AutoPatch registra a verificação.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.