CloudOps Orchestration Service:Orchestrate OOS with 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 Create a RAM user e Grant permissions to a RAM user. 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 usando um dos métodos a seguir:

  • Use Terraform in Terraform Explorer: A Alibaba Cloud oferece um ambiente de execução online para o Terraform. Faça login no Terraform Explorer para usar a ferramenta sem instalação local. Esta opção é ideal para cenários que exigem uso e depuração do Terraform de forma eficiente, conveniente e sem custos.

  • Use Terraform in Cloud Shell: O Terraform vem pré-instalado no Cloud Shell, com credenciais de identidade configuradas. Execute comandos do Terraform diretamente no Cloud Shell. Recomendado para quem busca agilidade e praticidade no uso e na depuração da ferramenta, mantendo baixos custos operacionais.

  • Install and configure Terraform on your on-premises machine: Indicado para situações com conexão de rede instável 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 executar o código.

   terraform apply

   Quando solicitado, insira yes e pressione a tecla Enter. Se a informação a seguir 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.

   Execute 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"
               # ...

   Faça login no console

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

Libere 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 Common commands.

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.