Além dos recursos de modelo de nuvem do Automation Assembler que você usa ao criar modelos de nuvem, também é possível criar seus próprios recursos personalizados.

Os recursos personalizados são objetos de ação do Automation Orchestrator ou de extensibilidade que você gerencia por meio do Automation Assembler com as ações de ciclo de vida definidas no recurso personalizado. O serviço de modelo de nuvem chama automaticamente os fluxos de trabalho apropriados do Automation Orchestrator ou as ações de extensibilidade quando a operação associada a uma ação de ciclo de vida específica é disparada. Você também pode estender a funcionalidade do tipo de recurso selecionando fluxos de trabalho ou ações de extensibilidade do Automation Orchestrator que podem ser usados como operações de dia 2.

Esse caso de uso usa fluxos de trabalho incorporados fornecidos na biblioteca do Automation Orchestrator. Ele inclui cadeias de caracteres ou valores prescritivos para demonstrar como realizar o processo. Você pode modificá-los para se adequação ao seu ambiente.

Para fins de referência, este caso de uso usa um projeto chamado DevOpsTesting. Você pode substituir esse projeto de amostra por qualquer projeto no seu ambiente.

Pré-requisitos

  • Verifique se você configurou uma integração do Automation Orchestrator. Consulte Configurar uma integração do Automation Orchestrator no Automation Assembler.
  • Verifique se os fluxos de trabalho que você está usando para as ações de criar, atualizar, destruir e dia 2 existem no Automation Orchestrator e são executados com sucesso a partir de lá.
  • No Automation Orchestrator, localize o tipo de recurso usado pelos fluxos de trabalho. Os fluxos de trabalho incluídos neste recurso personalizado devem usar o mesmo tipo de recurso. Nesse caso de uso, o tipo de recurso é AD:User. Para obter mais informações sobre validação de tipos de recursos, consulte Tipos de recursos personalizados para modelos de nuvem do Automation Assembler.
  • Usando os fluxos de trabalho integrados do Active Directory na sua integração do Automation Orchestrator, configure um servidor do Active Directory.
  • Verifique se você sabe como configurar e implantar um modelo de nuvem de máquina.

Procedimento

  1. Crie um recurso personalizado do Active Directory para adicionar um usuário a um grupo.
    Essa etapa adiciona o recurso personalizado à tela de design de modelo de nuvem como um tipo de recurso.
    1. No Automation Assembler, selecione Projetar > Recursos Personalizados e clique em Novo Recurso Personalizado.
    2. Forneça os seguintes valores.

      Lembre-se de que, exceto para nomes de fluxo de trabalho, esses são valores de amostra.

      Configuração Valor de amostra
      Nome Usuário do AD

      Este é o nome do recurso que aparece na paleta de tipos de recursos do modelo de nuvem.
      Tipo de Recurso Custom.ADUser

      O tipo de recurso deve começar com Custom. e cada tipo de recurso devem ser exclusivos.

      Embora a inclusão de Custom. não é validado na caixa de texto. A cadeia de caracteres será adicionada automaticamente se você a remover.

      Esse tipo de recurso é adicionado à paleta de tipos de recursos para que você possa usá-lo no modelo de nuvem.

    3. Para habilitar esse tipo de recurso na lista de tipos de recurso de modelo de nuvem, verifique se a opção Ativar está ativa.
    4. Selecione a configuração de Escopo que disponibiliza o tipo de recurso para qualquer projeto.
    5. Em Baseado em, verifique se Inventário do vRO está selecionado como provedor de ação de ciclo de vida.
    6. Selecione os fluxos de trabalho que definem o recurso e as ações de dia 2.
      Observação: Os fluxos de trabalho de dia 2 selecionados devem ter um parâmetro de entrada que seja do mesmo tipo que o tipo externo. A entrada de tipo externo não é exibida no formulário personalizado de dia 2 solicitado pelo usuário, pois é automaticamente vinculada ao recurso personalizado.
      Configuração Valor de amostra
      Ações de ciclo de vida - Criar Selecione o fluxo de trabalho Criar um usuário com uma senha em uma unidade organizacional.

      Se você tiver várias integrações do Automation Orchestrator, selecione o fluxo de trabalho na instância de integração usada para executar esses recursos personalizados.

      Após a seleção do fluxo de trabalho, o menu suspenso de tipos externos ficará disponível e será automaticamente definido como AD:User.

      Observação: Um tipo de fonte externa poderá ser usado apenas uma vez se compartilhado e uma vez por projeto. Neste caso de uso, você está fornecendo o mesmo recurso personalizado para todos os projetos. Isso significa que você não pode usar AD:User para quaisquer outros tipos de recursos para todos os projetos. Se você tiver outros fluxos de trabalho que exijam o tipo AD:User, será necessário criar recursos personalizados individuais para cada projeto.
      Ações de ciclo de vida - Destruir Selecione o fluxo de trabalho Destruir um usuário.
      Ações adicionais Selecione o fluxo de trabalho Alterar a senha de um usuário.

      Na janela Adicionar Ação, insira um nome para a ação, como password_change, e clique em Adicionar.

      Para modificar o formulário de solicitação de ação ao qual o usuário responde quando solicita a ação, clique no ícone na coluna Parâmetros de Solicitação.
      Observação: Para fluxos de trabalho de ação adicionais, verifique se o fluxo de trabalho tem um parâmetro de entrada que seja do mesmo tipo que o tipo externo.

      Neste exemplo, não há uma aplicação apropriada de um fluxo de trabalho de atualização. Um exemplo comum de um fluxo de trabalho de atualização, que faz alterações no recurso personalizado provisionado, é dimensionar ou expandir uma implantação.

    7. Revise os valores de chave e tipo de esquema na guia Propriedades para compreender as entradas de fluxo de trabalho e poder configurar as entradas no modelo de nuvem.
      O esquema lista os valores de entrada obrigatórios e opcionais definidos no fluxo de trabalho. Os valores de entrada necessários estão incluídos no YAML do modelo de nuvem.

      Em Criar um fluxo de trabalho de usuário, accountName, displayName e ouContainer são valores de entrada necessários. As outras propriedades do esquema não são necessárias. Você também pode usar o esquema para determinar onde deseja criar associações a outros valores de campo, fluxos de trabalho ou ações. Associações não estão incluídas neste caso de uso.

    8. Para concluir a criação do recurso personalizado, clique em Criar.
  2. Crie um modelo de nuvem que adicione o usuário a uma máquina quando você o implantar.
    1. Selecione Projetar > Modelos de Nuvem e clique em Novo a partir de > Tela em branco.
    2. Especifique o nome Máquina com um usuário do AD para o modelo de nuvem.
    3. Selecione o projeto DevOpsTesting e clique em Criar.
    4. Adicione e configure uma máquina vSphere.
    5. Na lista de recursos personalizados à esquerda da página de design de modelo de nuvem, arraste o tipo de recurso Usuário do AD até a tela.
      Observação: Você pode selecionar o recurso personalizado rolando para baixo e selecionando-o no painel esquerdo ou procurando-o na caixa de texto Pesquisar Tipos de Recurso. Se o recurso personalizado não for exibido, clique no botão Atualizar ao lado da caixa de texto Pesquisar Tipos de Recurso.
    6. À direita, edite o código YAML para adicionar os valores de entrada obrigatórios e a senha.
      Adicione uma seção inputs no código para que os usuários possam fornecer o nome dos usuários que estão adicionando. No exemplo a seguir, alguns desses valores são dados de amostra. Seus valores podem ser diferentes. 
      inputs:
  accountName:
    type: string
    title: Account name
    encrypted: true   
  displayName:
    type: string
    title: Display name   
  password:
    type: string
    title: Password
    encrypted: true 
  confirmPassword:
    type: string
    title: Password
    encrypted: true   
  ouContainer: 
    type: object
    title: AD OU container
    $data: 'vro/data/inventory/AD:OrganizationalUnit'
    properties:
        id:
            type: string
        type:
            type: string
    7. Na seção resources, adicione o código ${input.input-name} para solicitar a seleção do usuário. 
      resources:
  Custom_ADUser_1:
    type: Custom.ADUser
    properties:
        accountName: '${input.accountName}'
        displayName: '${input.displayName}'
        ouContainer: '${input.ouContainer}'
        password: '${input.password}'
        confirmPassword: '${input.confirmPassword}'
  3. Implante o modelo de nuvem.
    1. Na página do designer de modelos de nuvem, clique em Implantar.
    2. Insira o Nome da Implantação Usuário do AD Scott.
    3. Selecione a Versão do Modelo de Nuvem e clique em Seguinte.
    4. Conclua as entradas de implantação.
    5. Clique em Implantar.
  4. Monitore a solicitação de provisionamento na página Implantações para garantir que o usuário seja adicionado ao Active Directory e que a implantação seja bem-sucedida.

O que Fazer Depois

Quando seu modelo de nuvem testado estiver funcionando, você poderá começar a usar o recurso personalizado Usuário do AD com outros modelos de nuvem.