ACS-ECS-BulkyInstallLogAgent - CloudOps Orchestration Service - Centro de documentación de Alibaba Cloud

Instale, actualice o desinstale el agente de Simple Log Service (Logtail) en varias instancias de Elastic Compute Service (ECS) de forma simultánea.

Property	Value
Nombre de la plantilla	ACS-ECS-BulkyInstallLogAgent
Tipo de plantilla	Automated
Propietario	Alibaba Cloud

Ejecutar ahora

Requisitos previos

Antes de empezar, compruebe que cuenta con lo siguiente:

Instancias ECS de destino que se encuentren en ejecución y accesibles.
Cloud Assistant instalado y en ejecución en cada instancia ECS de destino. La plantilla usa ACS::ECS::RunCommand para ejecutar scripts de forma remota.
Acceso a la red interna desde las instancias ECS hacia el endpoint regional de Object Storage Service (OSS), necesario para descargar el instalador de Logtail.
Un rol de Resource Access Management (RAM) con los permisos obligatorios, si utiliza el parámetro OOSAssumeRole. Consulte Permisos obligatorios.

Funcionamiento

La plantilla ejecuta los siguientes pasos:

Obtener las instancias de destino: selecciona las instancias ECS que coinciden con el filtro targets mediante la acción ACS::SelectTargets. Además, detecta el tipo de sistema operativo de cada instancia (Linux o Windows).
Ejecutar comandos específicos del sistema operativo: recorre cada instancia y ejecuta el script correspondiente:
- Linux: descarga logtail.sh desde el endpoint interno de OSS y lo ejecuta como un script de shell (RunShellScript).
- Windows: descarga logtail_installer.zip desde el endpoint interno de OSS, extrae su contenido y ejecuta logtail_installer.exe como un script de PowerShell (RunPowerShellScript).
Devolver resultados: agrupa la salida de los comandos de todas las instancias en el parámetro de salida commandOutput.

Modos de acción

El parámetro action determina la operación que se aplica en cada instancia.

Action	Behavior
`install` (predeterminado)	Instala Logtail. Si Logtail ya está instalado y `overwrite` es `false` (valor predeterminado), la plantilla omite la instancia y devuelve `already has LogAgent`. Establezca `overwrite` en `true` para reinstalar Logtail en las instancias donde ya está presente.
`upgrade`	Actualiza Logtail a la versión más reciente. En Linux, ejecuta `logtail.sh upgrade`. En Windows, desinstala el agente existente y lo vuelve a instalar.
`uninstall`	Elimina Logtail de la instancia. En Linux, ejecuta `logtail.sh uninstall`. En Windows, ejecuta `logtail_installer.exe uninstall`.

Detección de agentes existentes

Cuando action es install y overwrite es false, la plantilla comprueba si Logtail ya está instalado al buscar las siguientes rutas:

Operating system	Path checked
Linux	`/usr/local/ilogtail/app_info.json`
Windows (64 bits)	`C:\Program Files (x86)\Alibaba\Logtail`
Windows (32 bits)	`C:\Program Files\Alibaba\Logtail`

Si la ruta existe, la plantilla omite la instancia.

Parámetros de entrada

Parameter	Type	Required	Default	Description
`targets`	Json	Sí	--	Las instancias ECS de destino. Utiliza la propiedad de asociación `Targets` con el tipo de recurso `ALIYUN::ECS::Instance`.
`regionId`	String	No	`{{ ACS::RegionId }}`	La región donde residen las instancias ECS. De forma predeterminada, toma la región de la ejecución actual de OOS.
`action`	String	No	`install`	La operación que se va a ejecutar. Valores permitidos: `install`, `upgrade` y `uninstall`.
`overwrite`	Boolean	No	`false`	Indica si se sobrescribe el agente Logtail existente en una instancia. De forma predeterminada, no se sobrescribe. Solo aplica cuando `action` es `install`.
`rateControl`	Json	No	`{"Mode": "Concurrency", "MaxErrors": 0, "Concurrency": 10}`	Controla la concurrencia y el umbral de errores de la operación por lotes.
`OOSAssumeRole`	String	No	`""` (vacío)	El rol de RAM que OOS asume para ejecutar esta plantilla. Déjelo vacío para usar los permisos del usuario actual.

Grupos de parámetros

La consola de OOS organiza estos parámetros en los siguientes grupos:

Group	Parameters
Configure Parameters	`action`, `overwrite`
Select Instances	`regionId`, `targets`
Control Options	`rateControl`, `OOSAssumeRole`

Configuración del control de velocidad

El parámetro rateControl es un objeto JSON con los siguientes subparámetros:

Sub-parameter	Type	Description
`Mode`	String	El modo de concurrencia. Establézcalo en `Concurrency` para especificar un número fijo de tareas paralelas.
`Concurrency`	Number	El número máximo de instancias que la plantilla procesa al mismo tiempo. Valor predeterminado: `10`.
`MaxErrors`	Number	El número máximo de errores permitidos antes de que la plantilla detenga el procesamiento de las instancias restantes. Valor predeterminado: `0` (se detiene en el primer error).

Valor predeterminado:

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

Parámetros de salida

Parameter	Type	Description
`commandOutput`	String	La salida agrupada de los comandos ejecutados en todas las instancias de destino.

Permisos obligatorios

Adjunte la siguiente política al rol de RAM especificado en OOSAssumeRole, o bien al usuario o rol de RAM que ejecuta la plantilla.

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

Esta política otorga el siguiente acceso:

ecs:DescribeInstances: consulta los detalles de las instancias para resolver el filtro targets.
ecs:RunCommand: ejecuta scripts de shell o PowerShell en las instancias de destino.
ecs:DescribeInvocations y ecs:DescribeInvocationResults: supervisa el estado de los comandos y recupera la salida.
oos:GetApplicationGroup: recupera la información del grupo de aplicaciones cuando los destinos se especifican por grupo de aplicaciones.

Comportamiento entre sistemas operativos

La plantilla detecta el sistema operativo de cada instancia y ejecuta el script de instalación correspondiente.

Linux

Descarga logtail.sh desde http://logtail-release-{regionId}.oss-{regionId}-internal.aliyuncs.com/linux64/logtail.sh.
Si la instalación es exitosa, muestra el contenido de /usr/local/ilogtail/app_info.json.
Utiliza la ejecución de scripts de shell (RunShellScript).

Windows

Descarga logtail_installer.zip desde http://logtail-release-{regionId}.oss-{regionId}-internal.aliyuncs.com/win/logtail_installer.zip.
Extrae los archivos en un directorio temporal (C:\Users\Administrator\OOSPackages), ejecuta el instalador y elimina los archivos temporales.
Utiliza la ejecución de scripts de PowerShell (RunPowerShellScript).
En Windows, upgrade realiza una desinstalación completa seguida de una reinstalación.

Solución de problemas

Issue	Possible cause	Solution
`Failed to download logtail_installer, Please check your network service.`	La instancia ECS no puede comunicarse con el endpoint interno de OSS de la región especificada.	Compruebe que la instancia tenga acceso por red interna a `logtail-release-{regionId}.oss-{regionId}-internal.aliyuncs.com`.
`already has LogAgent`	Logtail ya está instalado y `overwrite` es `false`.	Establezca `overwrite` en `true` para reinstalar, o use `upgrade` para actualizar a la versión más reciente.
Tiempo de espera agotado o error en el comando	Es posible que Cloud Assistant no se esté ejecutando en la instancia de destino, o que la instancia esté detenida.	Compruebe que la instancia se encuentre en el estado Running y que Cloud Assistant esté instalado y en ejecución.
Errores de permiso denegado	El usuario o el rol `OOSAssumeRole` carece de los permisos obligatorios.	Adjunte la política de RAM indicada en Permisos obligatorios.

Código fuente de la plantilla

Para consultar la plantilla YAML completa, visite ACS-ECS-BulkyInstallLogAgent.yml en GitHub.