CloudOps Orchestration Service:Orquestrar OOS com Terraform

Pré-requisitos

• Recomendamos usar um usuário RAM com as permissões mínimas necessárias para executar as operações deste tópico. Essa prática reduz o risco de vazamento do par AccessKey da sua conta Alibaba Cloud. Para mais informações, consulte Criar um usuário RAM e Conceder permissões a um usuário RAM. Exemplo de política:

  {
    "Version": "1",
    "Statement": [
      {
        "Effect": "Allow",
        "Action": [
          "oos:GetApplication",
          "oos:DeleteApplication",
          "oos:CreateApplication",
          "oos:ListApplications"
        ],
        "Resource": "*"
      }
    ]
  }

• Prepare o ambiente de execução do Terraform por um dos métodos a seguir:

  • Usar o Terraform no Terraform Explorer: A Alibaba Cloud oferece um ambiente de execução online para o Terraform. Acesse o Terraform Explorer para usar a ferramenta sem instalação local. Ideal para cenários que exigem uso e depuração do Terraform de forma eficiente, conveniente e sem custos.

  • Usar o Terraform no Cloud Shell: O Cloud Shell já vem com o Terraform pré-instalado e credenciais de identidade configuradas. Execute comandos do Terraform diretamente no Cloud Shell. Recomendado para uso e depuração ágeis e práticos, com baixo custo.

  • Instale e configure o Terraform na máquina local: Indicado para situações com conexões de rede instáveis ou quando é necessário um ambiente de desenvolvimento personalizado.

Recursos necessários

• alicloud_oos_application: Uma aplicação no OOS.

Crie uma aplicação

1. Crie um diretório de trabalho e um arquivo chamado main.tf nesse diretório. Em seguida, copie o conteúdo abaixo para o arquivo main.tf.

   variable "region" {
     default = "cn-hangzhou"
   }
   
   provider "alicloud" {
     region = var.region
   }
   
   variable "name" {
     default = "terraform-example"
   }
   
   resource "random_integer" "default" {
     min = 10000
     max = 99999
   }
   
   data "alicloud_resource_manager_resource_groups" "default" {}
   
   resource "alicloud_oos_application" "default" {
     resource_group_id = data.alicloud_resource_manager_resource_groups.default.groups.0.id
     application_name  = "${var.name}-${random_integer.default.result}"
     description       = var.name
     tags = {
       Created = "TF"
     }
   }

2. Execute o comando a seguir para inicializar o ambiente de execução do Terraform:

   terraform init

   Se a mensagem abaixo for retornada, o Terraform foi inicializado com sucesso.

   Terraform has been successfully initialized!
   
   You may now begin working with Terraform. Try running "terraform plan" to see
   any changes that are required for your infrastructure. All Terraform commands
   should now work.
   
   If you ever set or change modules or backend configuration for Terraform,
   rerun this command to reinitialize your working directory. If you forget, other
   commands will detect it and remind you to do so if necessary.

3. Execute o comando a seguir para execute o código.

   terraform apply

   Quando solicitado, insira yes e pressione a tecla Enter. Se a informação abaixo for exibida, a aplicação OOS foi criada.

   You can apply this plan to save these new output values to the Terraform state, without changing any real infrastructure.
   
   Do you want to perform these actions?
     Terraform will perform the actions described above.
     Only 'yes' will be accepted to approve.
   
     Enter a value: yes
   
   Apply complete! Resources: 2 added, 0 changed, 0 destroyed.

4. Verifique o resultado.

   Executar o comando terraform show

   No diretório de trabalho, execute o comando abaixo para consultar os detalhes do recurso criado com o Terraform:

   terraform show

   shell@Alicloud:~/oos$ terraform show
   # alicloud_oos_application.default:
   resource "alicloud_oos_application" "default" {
       application_name  = "terraform-example-xxx"
       description       = "terraform-example"
       id                = "terraform-example-xxx"
       resource_group_id = "rg-xxx"
       tags              = {
           "Created" = "TF"
       }
   }
   
   # data.alicloud_resource_manager_resource_groups.default:
   data "alicloud_resource_manager_resource_groups" "default" {
       enable_details = false
       groups         = [
           {
               account_id   = "xxx"
               display_name = "default resource group"
               id           = "rg-xxx"
               name         = "default"
               # ...

   Fazer login no console

   Acesse o console do OOS. Na página Application Management, visualize a aplicação criada.

Liberar recursos

Caso não precise mais dos recursos criados pelo Terraform, execute o comando abaixo para liberá-los. Para mais detalhes sobre o comando terraform destroy, consulte Comandos comuns.

terraform destroy

Código de exemplo completo

variable "region" {
  default = "cn-hangzhou"
}

provider "alicloud" {
  region = var.region
}

variable "name" {
  default = "terraform-example"
}

resource "random_integer" "default" {
  min = 10000
  max = 99999
}

data "alicloud_resource_manager_resource_groups" "default" {}

resource "alicloud_oos_application" "default" {
  resource_group_id = data.alicloud_resource_manager_resource_groups.default.groups.0.id
  application_name  = "${var.name}-${random_integer.default.result}"
  description       = var.name
  tags = {
    Created = "TF"
  }
}

Para visualizar outros códigos de exemplo, acesse o GitHub.