ACS-ECS-BulkyInstallLogAgent - CloudOps Orchestration Service: Central de Documentação do Alibaba Cloud

Pré-requisitos

Antes de começar, verifique se:

As instâncias ECS de destino estão em execução e acessíveis.
O Cloud Assistant está instalado e em execução em cada instância ECS de destino (o modelo usa a ação ACS::ECS::RunCommand para executar scripts remotamente).
As instâncias ECS têm acesso pela rede interna ao endpoint regional do Object Storage Service (OSS) para baixar o instalador do Logtail.
Você possui uma função do Resource Access Management (RAM) com as permissões necessárias, caso utilize o parâmetro OOSAssumeRole (consulte Permissões necessárias).

Como funciona

Este modelo executa as seguintes etapas:

Obter instâncias de destino: selecione as instâncias ECS correspondentes ao filtro targets por meio da ação ACS::SelectTargets e identifica o tipo de sistema operacional de cada instância (Linux ou Windows).
Executar comandos específicos do SO: itera sobre cada instância e executa o script apropriado:
- Linux: baixe o arquivo logtail.sh do endpoint interno do OSS e o execute como script de shell (RunShellScript).
- Windows: baixe o pacote logtail_installer.zip do endpoint interno do OSS, extraia seu conteúdo e execute o logtail_installer.exe como script powershell (RunPowerShellScript).
Retornar resultados: consolida a saída dos comandos de todas as instâncias no parâmetro de saída commandOutput.

Modos de ação

O parâmetro action define a operação em cada instância.

Ação	Comportamento
`install` (padrão)	Instale o Logtail. Se o Logtail já estiver instalado e `overwrite` for `false` (padrão), o modelo ignora a instância e retorna `already has LogAgent`. Defina `overwrite` como `true` para reinstalar o Logtail nas instâncias onde ele já existe.
`upgrade`	Atualize o Logtail para a versão mais recente. No Linux, execute `logtail.sh upgrade`. No Windows, desinstale o agente existente e o reinstale.
`uninstall`	Remove o Logtail da instância. No Linux, execute `logtail.sh uninstall`. No Windows, execute `logtail_installer.exe uninstall`.

Detecção de agente existente

Quando action é install e overwrite é false, o modelo verifica se o Logtail já está instalado buscando os seguintes caminhos:

Sistema operacional	Caminho verificado
Linux	`/usr/local/ilogtail/app_info.json`
Windows (64 bits)	`C:\Program Files (x86)\Alibaba\Logtail`
Windows (32 bits)	`C:\Program Files\Alibaba\Logtail`

Se o caminho existir, o modelo ignorará a instância.

Parâmetros de entrada

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`targets`	Json	Sim	--	Instâncias ECS de destino da operação. Usa a propriedade de associação `Targets` com o tipo de recurso `ALIYUN::ECS::Instance`.
`regionId`	String	Não	`{{ ACS::RegionId }}`	Região onde as instâncias ECS estão localizadas. O padrão é a região da execução atual do OOS.
`action`	String	Não	`install`	Operação a executar. Valores permitidos: `install`, `upgrade`, `uninstall`.
`overwrite`	Boolean	Não	`false`	Define se o agente Logtail existente na instância será substituído. Por padrão, não há substituição. Aplica-se apenas quando `action` é `install`.
`rateControl`	Json	Não	`{"Mode": "Concurrency", "MaxErrors": 0, "Concurrency": 10}`	Controla a simultaneidade e o limiar de erros da operação em lote.
`OOSAssumeRole`	String	Não	`""` (vazio)	Função RAM que o OOS assume para executar este modelo. Deixe em branco para usar as permissões do usuário atual.

Grupos de parâmetros

O console do OOS organiza esses parâmetros nos seguintes grupos:

Grupo	Parâmetros
Configure Parameters	`action`, `overwrite`
Select Instances	`regionId`, `targets`
Control Options	`rateControl`, `OOSAssumeRole`

Configurações de controle de taxa

O parâmetro rateControl é um objeto JSON composto pelos seguintes subparâmetros:

Subparâmetro	Tipo	Descrição
`Mode`	String	Modo de simultaneidade. Defina como `Concurrency` para especificar um número fixo de tarefas paralelas.
`Concurrency`	Number	Número máximo de instâncias que o modelo processa simultaneamente. Padrão: `10`.
`MaxErrors`	Number	Número máximo de erros permitidos antes que o modelo interrompa o processamento das instâncias restantes. Padrão: `0` (interrompe no primeiro erro).

Valor padrão:

{
  "Mode": "Concurrency",
  "MaxErrors": 0,
  "Concurrency": 10
}

Parâmetros de saída

Parâmetro	Tipo	Descrição
`commandOutput`	String	Saída consolidada dos comandos executados em todas as instâncias de destino.

Permissões necessárias

Anexe a política seguinte à função RAM especificada em OOSAssumeRole ou ao usuário/função RAM que executa o modelo.

{
    "Version": "1",
    "Statement": [
        {
            "Action": [
                "ecs:DescribeInstances",
                "ecs:DescribeInvocationResults",
                "ecs:DescribeInvocations",
                "ecs:RunCommand"
            ],
            "Resource": "*",
            "Effect": "Allow"
        },
        {
            "Action": [
                "oos:GetApplicationGroup"
            ],
            "Resource": "*",
            "Effect": "Allow"
        }
    ]
}

Essa política concede os seguintes acessos:

ecs:DescribeInstances: consulta detalhes das instâncias para resolver o filtro targets.
ecs:RunCommand: execute scripts shell ou powershell nas instâncias de destino.
ecs:DescribeInvocations e ecs:DescribeInvocationResults: monitoram o status dos comandos e obtêm suas saídas.
oos:GetApplicationGroup: recupera informações de grupos de aplicações quando os destinos são definidos por grupo de aplicação.

Comportamento entre sistemas operacionais

O modelo identifica o sistema operacional de cada instância e executa o script de instalação correspondente.

Linux

Baixe logtail.sh de http://logtail-release-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux64/logtail.sh.
Após uma instalação bem-sucedida, exibe o conteúdo de /usr/local/ilogtail/app_info.json.
Usa execução de script shell (RunShellScript).

Windows

Baixe o arquivo logtail_installer.zip de http://logtail-release-{regionId}.oss-{regionId}-internal.aliyuncs.com/win/logtail_installer.zip.
Extraia os arquivos para um diretório temporário (C:\Users\Administrator\OOSPackages), execute o instalador e remova os arquivos temporários.
Usa execução de script powershell (RunPowerShellScript).
No Windows, a ação upgrade realiza uma desinstalação completa seguida de nova instalação.

Solução de problemas

Problema	Possível causa	Solução
`Failed to download logtail_installer, Please check your network service.`	A instância ECS não consegue alcançar o endpoint interno do OSS na região especificada.	Verifique se a instância tem acesso pela rede interna a `logtail-release-{regionId}.oss-{regionId}-internal.aliyuncs.com`.
`already has LogAgent`	O Logtail já está instalado e `overwrite` está definido como `false`.	Defina `overwrite` como `true` para reinstalar ou use `upgrade` para atualizar para a versão mais recente.
Tempo limite ou falha no comando	O Cloud Assistant pode não estar em execução na instância de destino, ou a instância pode estar parada.	Verifique se a instância está no estado Running e se o Cloud Assistant está instalado e em execução.
Erros de permissão negada	O usuário ou a função `OOSAssumeRole` não tem as permissões necessárias.	Anexe a política RAM descrita em Permissões necessárias.

Código-fonte do modelo

Para obter o modelo YAML completo, consulte ACS-ECS-BulkyInstallLogAgent.yml no GitHub.

Propriedade	Valor
Nome do modelo	ACS-ECS-BulkyInstallLogAgent
Tipo de modelo	Automatizado
Proprietário	Alibaba Cloud