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

Este tópico descreve como escrever um modelo, criar uma stack, visualizar uma stack e excluir uma stack no Resource Orchestration Service (ROS) para que você comece rapidamente.

Pré-requisitos

É necessária uma conta Alibaba Cloud. Caso não tenha uma, registre uma conta.

Cenário de exemplo

O Resource Orchestration Service (ROS) permite implantar simultaneamente vários recursos de nuvem e suas dependências, ou implantar o mesmo conjunto de recursos em várias regiões. Por exemplo, é possível implantar instâncias ECS e instâncias conectadas à VPC. O ROS oferece implantação automatizada. Este tópico usa a criação de uma virtual private cloud (VPC) e de um vSwitch como exemplo.

Etapa 1: Escrever um modelo

Um modelo é um arquivo de texto nos formatos JSON, YAML ou Terraform com codificação UTF-8. Nele, você define os recursos da Alibaba Cloud, configura suas propriedades e especifica suas dependências. Em seguida, crie uma stack com base nesse modelo. Escreva seu próprio modelo seguindo a estrutura de modelos e os tipos de recursos suportados ou utilize um modelo de exemplo. Para mais informações sobre como escrever um modelo, consulte Guia de início rápido para escrever um modelo. Para mais detalhes sobre estruturas de modelos, veja Estrutura de modelos JSON e YAML e Estrutura de modelos Terraform.

O modelo YAML de exemplo a seguir mostra como criar 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

A descrição do modelo é a seguinte:

ROSTemplateFormatVersion: Número da versão do modelo. A versão atual é 2015-09-01.
Description: Descrição do modelo. Use esta seção para descrever a finalidade e a arquitetura dos recursos definidos no modelo. Uma descrição detalhada ajuda outros usuários a entenderem seu modelo.
Parameters: Parâmetros do modelo. Neste exemplo, os parâmetros incluem 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, consulte Parâmetros.
Resources: Recursos da Alibaba Cloud definidos no modelo. Neste exemplo, uma VPC e um vSwitch são criados. As propriedades dos recursos referenciam os parâmetros definidos na seção Parameters. Para mais informações, consulte Recursos, ALIYUN::ECS::VPC e ALIYUN::ECS::VSwitch.
Outputs: Informações de recursos retornadas após a criação da stack. Neste exemplo, o sistema retorna o id da VPC e o id do vSwitch. Para mais informações, consulte Saídas.

Etapa 2: Criar uma stack

Faça login no console ROS.
No painel de navegação à esquerda, clique em Stacks.
Na barra de navegação superior, selecione a região onde deseja criar a stack na lista suspensa de regiões, como China (Hangzhou).
Na página Stacks, clique em Create Stack. Na seção Specify Template, clique em Select an Existing Template.
Nota
- Se você selecionar Create Template ou ROS Infrastructure Composer, será redirecionado para a página correspondente.
Na página Specify Template, clique em Select an Existing Template na seção Specify Template. Defina Template Import Method como Enter Template Content. Na seção Template Content, clique na aba ROS e insira o modelo YAML da Etapa 1: Escrever um modelo. Clique em Next.

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

Para mais informações sobre como configurar as propriedades da stack, consulte Criar uma 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.	China (Hangzhou) Zone K
`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 vSwitch e a VPC devem estar no mesmo bloco CIDR.	192.168.0.0/24
`Tags`	Tags. É possível adicionar até 20 tags. Cada tag é um par chave-valor. O valor da tag pode ficar vazio.	[{"Key": "ros", "Value": "beginner-tutorial"}]

Clique em Create.

Etapa 3: Visualizar a stack

No painel de navegação à esquerda, clique em Stacks.
Na barra de navegação superior, selecione a região onde deseja visualizar a stack na lista suspensa de regiões, como China (Hangzhou).
Na página Stacks, localize a stack e clique no id dela na coluna Stack Name.
Na página de gerenciamento da stack, execute as operações a seguir para visualizar as informações:
- Clique na aba Stack Information para visualizar informações nas seções Basic information e Stack Policy.
- Acesse a aba Event para ver os eventos ocorridos durante o ciclo de vida da stack.
- Selecione a aba Resources para consultar informações sobre cada recurso na stack.
- Utilize a aba Output para verificar as saídas especificadas no modelo durante a criação da stack.
- Abra a aba Parameter para examinar os parâmetros definidos no modelo ao criar a stack, incluindo os pseudoparâmetros do ROS que começam com ALIYUN::.
- Verifique a aba Drift para analisar as informações 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, utilize os recursos contidos nela. Por exemplo, implante outros recursos da Alibaba Cloud no vSwitch pertencente à VPC.

No painel de navegação à esquerda do console ROS, clique em Stacks.
Na página Stacks, clique no id da stack criada.
Clique na aba Resources e, em seguida, clique no id do recurso do vSwitch.
Na página de detalhes do vSwitch no console VPC, visualize informações básicas sobre o vSwitch, como id, zona e id da VPC à qual ele pertence.
Implante recursos da Alibaba Cloud no vSwitch.

Para mais informações, consulte Criar recursos de nuvem.

Etapa 5 (Opcional): Atualizar a stack

Para modificar recursos em uma stack, como alterar o VpcName, atualize a stack.

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

Etapa 6 (Opcional): Excluir a stack

Quando não precisar mais dos recursos de uma stack, exclua-a. Isso libera os recursos e ajuda a evitar cobranças desnecessárias.

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

Próximos passos

Para conhecer o processo completo de criação de uma stack, consulte Criar uma stack.
Para implantar stacks em várias contas e regiões, veja Grupos de stacks.
Para visualizar a arquitetura de recursos e gerenciá-los visualmente, acesse Cenários de recursos.
Para obter informações sobre sintaxe e estrutura de modelos, consulte Sintaxe de modelos e Estrutura de modelos Terraform.
Para gerenciar recursos existentes, veja Importação de recursos.