Resource Orchestration Service (ROS) Quick Start - Resource Orchestration Service: Central de Documentação do Alibaba Cloud

Com o Resource Orchestration Service (ROS), você define um grupo de recursos da Alibaba Cloud em um modelo e os implanta como uma única stack. Este tópico descreve o fluxo de trabalho baseado em modelos no console do ROS, desde a escrita do modelo até a exclusão da stack.

Pré-requisitos

Certifique-se de ter uma conta Alibaba Cloud. Caso não tenha, crie uma conta.

Cenário de exemplo

Para implantar vários recursos de nuvem e suas dependências simultaneamente, ou provisionar recursos com as mesmas dependências em várias regiões (como instâncias ECS e instâncias conectadas à VPC), use o ROS para automatizar a implantação. Este tópico toma como exemplo a criação rápida de uma Virtual Private Cloud (VPC) e de um vSwitch.

Etapa 1: Escrever um modelo

Um modelo é um arquivo de texto nos formatos JSON, YAML ou Terraform com codificação UTF-8. Use-o para definir recursos da Alibaba Cloud e seus detalhes de configuração, especificar dependências entre recursos e criar uma stack. Você pode escrever um modelo seguindo a estrutura de modelos e os tipos de recursos, ou usar um modelo de exemplo. Para mais informações sobre como escrever um modelo, consulte Quick start for writing a template. Para mais detalhes sobre estruturas de modelos, consulte JSON and YAML template structure e Terraform template structure.

Este tópico usa o seguinte modelo YAML de exemplo, que cria uma VPC e um vSwitch:

Criar uma VPC e um vSwitch

ROSTemplateFormatVersion: '2015-09-01'
Description: Example of provisioning VPC and vSwitch.
Parameters:
  VpcName:
    Type: String
    Description: The name must be 2 to 128 characters in length and can contain letters, digits, underscores (_), and hyphens (-). It must start with a letter and cannot start with http:// or https://.
    Default: null
  VpcCidrBlock:
    Type: String
    Description: The CIDR block of the VPC.
    Default: 192.168.0.0/16
    AllowedValues:
      - 10.0.0.0/8
      - 172.16.0.0/12
      - 192.168.0.0/16
  ZoneId:
    Type: String
    Description: Zone ID.
    AssociationProperty: ALIYUN::ECS::Instance::ZoneId
  VSwitchName:
    Type: String
    Description: The name must be 2 to 128 characters in length and can contain letters, digits, underscores (_), and hyphens (-). It must start with a letter and cannot start with http:// or https://.
    Default: null
  VSwitchCidrBlock:
    Type: String
    Description: The CIDR block of the VSwitch.
    Default: 192.168.0.0/24
    AllowedValues:
      - 10.0.0.0/24
      - 172.16.0.0/24
      - 192.168.0.0/24
  Tags:
    Type: Json
    Description: A maximum of 20 tags can be specified. Each tag is a key-value pair. The tag value can be left empty.
    Default:
      - Key: ros
        Value: beginner-tutorial
Resources:
  Vpc:
    Type: ALIYUN::ECS::VPC
    Properties:
      VpcName:
        Ref: VpcName
      CidrBlock:
        Ref: VpcCidrBlock
      Tags:
        Ref: Tags
  VSwitch:
    Type: ALIYUN::ECS::VSwitch
    Properties:
      VpcId:
        Ref: Vpc
      ZoneId:
        Ref: ZoneId
      VSwitchName:
        Ref: VSwitchName
      CidrBlock:
        Ref: VSwitchCidrBlock
      Tags:
        Ref: Tags
Outputs:
  VpcId:
    Description: The VPC ID allocated by the system.
    Value:
      Fn::GetAtt:
        - Vpc
        - VpcId
  VSwitchId:
    Description: The VSwitch ID allocated by the system.
    Value:
      Fn::GetAtt:
        - VSwitch
        - VSwitchId

Os componentes do modelo são descritos a seguir:

ROSTemplateFormatVersion: versão do modelo. A versão atual é 2015-09-01.
Description: descrição do modelo. Use esta seção para descrever os cenários de aplicação e a arquitetura criada. Uma descrição detalhada facilita o entendimento do conteúdo do modelo.
Parameters: parâmetros do modelo. Este exemplo define parâmetros para o nome da VPC (VpcName), bloco CIDR da VPC (VpcCidrBlock), ID da zona (ZoneId), nome do vSwitch (VSwitchName), bloco CIDR do vSwitch (VSwitchCidrBlock) e tags (Tags). Para mais informações sobre como definir parâmetros, consulte Parameters.
Resources: recursos da Alibaba Cloud contidos no modelo. Este exemplo cria uma VPC e um vSwitch. As propriedades dos recursos referenciam os parâmetros definidos em Parameters. Para mais informações, consulte Resources, ALIYUN::ECS::VPC e ALIYUN::ECS::VSwitch.
Outputs: informações de recursos retornadas após a criação da stack. Este exemplo retorna o ID da VPC e o ID do vSwitch. Para mais informações, consulte Outputs.

Etapa 2: Criar uma stack

Faça login no console do ROS.
No painel de navegação à esquerda, clique em Stacks.
Na barra de navegação superior, selecione uma região na lista suspensa, como China (Hangzhou).
Na página Stacks, clique em Create Stack. Na seção Specify Template, clique em Select an Existing Template.
Nota
- Se selecionar Create Template ou ROS Infrastructure Composer, você será redirecionado para a página correspondente.
Na página Specify Template, clique em Select an Existing Template na seção Specify Template. Para colar o conteúdo do modelo diretamente no console, defina Template Import Method como Enter Template Content. Na aba ROS da seção Template Content, insira o modelo YAML criado na Step 1: Write a template e clique em Next.

Na página Configure Parameters, insira um nome para a stack, configure os parâmetros do modelo a seguir e clique em Next.

Para obter detalhes sobre as propriedades da stack configuradas nesta etapa, consulte Create a stack.

Parâmetro	Descrição	Exemplo
`VpcName`	Nome da VPC.	myVPC
`VpcCidrBlock`	Bloco CIDR da VPC. Valores válidos: 10.0.0.0/8 172.16.0.0/12 192.168.0.0/16 (padrão)	192.168.0.0/16
`ZoneId`	ID da zona.	Zona K na região China (Hangzhou)
`VSwitchName`	Nome do vSwitch.	myVSwitch
`VSwitchCidrBlock`	Bloco CIDR do vSwitch. Valores válidos: 10.0.0.0/24 172.16.0.0/24 192.168.0.0/24 Nota O bloco CIDR do vSwitch deve estar contido no bloco CIDR da VPC à qual pertence.	192.168.0.0/24
`Tags`	Tags. É possível especificar até 20 tags. Cada tag é um par chave-valor. O valor da tag pode ficar em branco.	[{"Key": "ros", "Value": "beginner-tutorial"}]

Clique em Create.

Etapa 3: Visualizar uma stack

No painel de navegação à esquerda, clique em Stacks.
Na barra de navegação superior, selecione uma região na lista suspensa, como China (Hangzhou).
Na página Stacks, localize a stack e clique no respectivo ID na coluna Stack Name.
Na página de gerenciamento da stack, realize as operações a seguir para visualizar as informações:
- Clique na aba Stack Information para ver dados nas seções Basic information e Stack Policy.
- Acesse a aba Event para consultar eventos ocorridos durante o ciclo de vida da stack.
- Use a aba Resources para verificar detalhes de cada recurso na stack.
- Selecione a aba Output para examinar as saídas especificadas no modelo durante a criação da stack.
- Verifique na aba Parameter os parâmetros especificados no modelo ao criar a stack, incluindo os pseudoparâmetros do ROS iniciados com ALIYUN::.
- Abra a aba Drift para analisar o status nas seções Stack Drift Status e Resource Drift Status.
- Consulte a aba Templates para visualizar o modelo da stack.
- Navegue até a aba Change Sets para ver os conjuntos de alterações da stack.

Etapa 4: Usar recursos na stack

Após criar a stack, use os recursos nela contidos conforme necessário. Por exemplo, implante recursos da Alibaba Cloud no vSwitch da VPC.

No painel de navegação à esquerda do console do ROS, clique em Stacks.
Na página Stacks, clique no ID da stack desejada.
Clique na aba Resources e, em seguida, clique no ID do recurso vSwitch.
No console da VPC, visualize as informações básicas sobre o vSwitch, incluindo o ID do vSwitch, a zona e o ID da VPC associada.
Implante recursos da Alibaba Cloud no vSwitch.

Para mais informações, consulte Create cloud resources.

Etapa 5 (Opcional): Atualizar uma stack

Para modificar um recurso em uma stack, como VpcName, atualize a stack.

No painel de navegação à esquerda do console do ROS, clique em Stacks.
Na página Stacks, localize a stack a ser atualizada e clique em Update na coluna Actions.
Na página Configure Template Parameters, atualize os parâmetros. Por exemplo, altere o valor de VpcName para testVPC.
Clique em Modify.

Etapa 6 (Opcional): Excluir uma stack

Quando os recursos criados não forem mais necessários, exclua a stack para liberá-los e evitar custos desnecessários.

Aviso

Ao excluir a stack e liberar seus recursos, a VPC e o vSwitch criados por ela também serão liberados. Certifique-se de que esses recursos não são mais necessários antes de continuar.

No painel de navegação à esquerda do console do ROS, clique em Stacks.
Na página Stacks, localize a stack a ser excluída e clique em Delete na coluna Actions.
Na caixa de diálogo Delete Stacks, defina Method to Delete the Stack como Release Resources para liberar os recursos criados pela stack.
Clique em OK.

Próximos passos

Para conhecer o processo completo de criação de uma stack, consulte Create a stack.
Para implantar stacks em cenários entre contas e entre regiões, consulte Stack groups.
Para visualizar a arquitetura geral de recursos e gerenciá-los graficamente, consulte Resource scenarios.
Para mais informações sobre sintaxe e estrutura de modelos, consulte Template syntax e Terraform template structure.
Para gerenciar recursos existentes, consulte Resource import.