CloudOps Orchestration Service:Manage custom extensions in batches

Necesita una instancia ECS desplegada en una VPC.

Para obtener más información, consulte Create an instance by using the wizard. Las extensiones personalizadas solo se pueden instalar o desinstalar en instancias que estén dentro de una VPC. Compruebe que el tipo de red de su instancia ECS sea VPC.

Necesita un rol RAM asociado a su instancia ECS.

Para obtener más información, consulte Step 1: Create a RAM role. Al crear el rol, preste atención a la configuración de los siguientes parámetros:

1. Cree una política de permisos personalizada.

   Para obtener más información, consulte Create a custom permission policy. El rol RAM debe incluir los permisos de la siguiente política:

   Script JSON de la política de permisos

   {
       "Version": "1",
       "Statement": [
           {
               "Action": [
                   "oos:GetTemplate"
               ],
               "Resource": "*",
               "Effect": "Allow"
           },
           {
               "Action": [
                   "oss:GetObject",
                   "oss:GetBucketAcl"
               ],
               "Effect": "Allow",
               "Resource": "*"
           }
       ]
   }

2. Cree un rol RAM.

   Para obtener más información, consulte Create a normal service role. Preste atención a la configuración de los siguientes parámetros:

   • En Alibaba Cloud Service, seleccione Alibaba Cloud Service.

   • En Role Type, seleccione Normal Service Role.

   • En Elastic Compute Service, seleccione Elastic Compute Service.

3. Otorgue permisos al rol RAM.

   Cuando otorgue un permiso a un rol RAM, en Permission Policy seleccione la política personalizada que creó en 2.a Create a custom permission policy. Para obtener más información, consulte Manage the permissions of a RAM role.

4. Asocie el rol RAM a la instancia ECS.

   En el parámetro RAM Role, seleccione el rol que creó y configuró en los pasos anteriores. Para obtener más información, consulte Step 1: Create a RAM role.

Necesita un bucket OSS para almacenar sus extensiones personalizadas.

Para obtener más información, consulte Create buckets. Cuando seleccione una Region, debe elegir Region-specific y seleccionar la misma región donde utiliza OOS.

Vaya a la consola de OOS, elija Server Management > Extensions en el panel de navegación izquierdo y haga clic en la pestaña Custom Extensions.

Haga clic en Create Custom Extension. En la sección Basic Information, configure los parámetros y luego haga clic en Next Step.

Las extensiones personalizadas solo son visibles para usted. Puede usar su cuenta para instalarlas o desinstalarlas. La siguiente tabla describe los parámetros principales.

En el paso Extension Configuration, configure los parámetros.

El siguiente código muestra ejemplos de un Installation Execution Script y un Uninstallation Execution Script:

• Ejemplo de script de ejecución de instalación

  #!/bin/bash
  #######  Notes on the installation script template for a single-process software package  #########
  #1. This script runs in the root directory by default. For Linux, the default directory is /root.
  #2. After the software is successfully installed, the remote download path is deleted by default.
  #3. We recommend that you add your custom logic in the job_start function.
  #4. You must store the process ID of the software package in the specified path.
  
  #######  error code specification  #########
  # Please update this documentation if new error codes are added.
  # 1   => Installation failed.
  # 2   => Health check failed.
  # 3   => Failed to record process ID.
  # 4   => User shell script failed.
  
  function user_shell() {
      # Custom installation script START
      $nohup java -jar demo-1.0.0-SNAPSHOT.jar > /demo.log 2>&1 &
      # Custom installation script END
  }
  
  ##### You can call this function when the script starts to print the timestamp and PID and record the process ID to the specified path.
  function job_start() {
      user_shell
      if [ $? -ne 0 ]; then
          exit4
      else
          # Do not delete this constraint.
          now=$(date +'%Y-%m-%d %H:%M:%S')
          pid=$!
          echo "[$now][$pid] job_start"
          pidPath="/etc/aliyun"
          if [ ! -d $pidPath ]; then
              mkdir -p /etc/aliyun
              echo "Create the PID storage path: $pidPath"
          fi
          echo "$pid" > "$pidPath/main_process_id"
          if [ $? -ne 0 ]; then
              exit3
          fi
      fi
  }
  
  ##### In this function, check whether the service is running. For example, you can check the process or run a curl command to an HTTP address.
  function check_health() {
      now=$(date +'%Y-%m-%d %H:%M:%S')
      echo "[$now][$$] check_health"
  }
  
  function exit1() {
    echo "exit code 1, install fail"
    exit 1
  }
  
  function exit2() {
    echo "exit code 2, check health fail"
    exit 2
  }
  
  function exit3() {
    echo "exit code 3, record process id fail"
    exit 3
  }
  
  function exit4() {
    echo "exit code 4, user shell fail"
    exit 4
  }
  
  ##### A return value of 0 indicates success. A non-zero value indicates failure.
  function main() {
      job_start
      if [ $? -ne 0 ]; then
          exit1
      fi
      check_health
      if [ $? -ne 0 ]; then
          exit2
      fi
  }
  
  ##### OOS automatically records logs for triggered executions.
  main

• Ejemplo de script de ejecución de desinstalación

  #!/bin/bash
  ##### You can call this function when the script starts to print the current timestamp and PID.
  function job_stop() {
      pid=$(cat /etc/aliyun/main_process_id)
      kill -9 $pid
      now=`date +'%Y-%m-%d %H:%M:%S'`
      echo "[$now][$pid] job_stop"
  }
  
  job_stop
  if [ $? -ne 0 ]; then
      echo "[$now][$$] job stop failed."
      exit 1
  fi

Haga clic en Create.

Una vez creada la extensión, podrá consultarla en la pestaña Custom Extensions.

Vaya a OOS console, elija Automated Tasks > Common O&M Tasks > Batch Software Management en el panel de navegación izquierdo y haga clic en Create.

En la página Create Batch Software Management Task, configure los parámetros y haga clic en Create.

• En Operation, seleccione Install.

• En Extension Name, seleccione Custom Extensions y luego elija la extensión personalizada que desea instalar.

• En Select Instances, seleccione Manually Select Instances. En la lista de instancias, seleccione las instancias ECS donde desea instalar la extensión personalizada. Asegúrese de que las instancias estén desplegadas en una VPC.

En el cuadro de diálogo Parameter Confirmation, compruebe los parámetros y haga clic en OK para crear la ejecución.

Una vez creada la ejecución, vaya a la página Task Execution Management para consultar el estado de instalación de la extensión personalizada en la lista de tareas.

Vaya a OOS console, elija Automated Tasks > Common O&M Tasks > Batch Software Management en el panel de navegación izquierdo y haga clic en Create.

En la página Create Batch Software Management Task, configure los parámetros y haga clic en Create.

• En Operation, seleccione Uninstall.

• En Extension Name, seleccione Custom Extensions y luego elija la extensión personalizada que desea desinstalar.

• En Select Instances, seleccione Manually Select Instances y elija las instancias ECS de las que desea desinstalar la extensión personalizada.

En el cuadro de diálogo Parameter Confirmation, compruebe los parámetros y haga clic en OK para crear la ejecución.

Una vez creada la ejecución, vaya a la página Task Execution Management para revisar la lista de tareas y confirmar que la extensión personalizada se desinstaló.