Configurar o aplicativo Web de Painel de Controle

Como parte do painel de controle da estrutura de automação do SAP, você pode criar um aplicativo Web interativo que ajudará a criar os arquivos de configuração necessários e a implantar zonas e sistemas de carga de trabalho SAP usando o Azure Pipelines.

Página frontal do aplicativo Web

Importante

O aplicativo Web de Painel de Controle está em VERSÃO PRÉVIA e ainda não está disponível na ramificação principal.

Criar o Registro do aplicativo

Se você quiser usar o aplicativo Web, primeiro precisará criar um registro de aplicativo para fins de autenticação. Abra o Azure Cloud Shell e execute os seguintes comandos:

Substitua MGMT pelo ambiente conforme necessário.

echo '[{"resourceAppId":"00000003-0000-0000-c000-000000000000","resourceAccess":[{"id":"e1fe6dd8-ba31-4d61-89e7-88639da4683d","type":"Scope"}]}]' >> manifest.json 

TF_VAR_app_registration_app_id=$(az ad app create \
    --display-name MGMT-webapp-registration \
    --enable-id-token-issuance true \
    --sign-in-audience AzureADMyOrg \
    --required-resource-access @manifest.json \
    --query "appId" | tr -d '"')

TF_VAR_webapp_client_secret=$(az ad app credential reset \
    --id $TF_VAR_app_registration_app_id --append               \
    --query "password" | tr -d '"')

rm manifest.json

Implantar com Azure Pipelines

Para obter instruções completas sobre como configurar o aplicativo Web usando o Azure DevOps, consulte Usar a Estrutura de Automação de Implantação do SAP nos Azure DevOps Services

Resumo das etapas necessárias para configurar o aplicativo Web antes de implantar o painel de controle:

  1. Adicione o pipeline de implantação do aplicativo Web (deploy/pipelines/21-deploy-web-app.yaml).
  2. Adicione as variáveis TF_VAR_app_registration_app_id e TF_VAR_webapp_client_secret ao grupo de variáveis específico do ambiente antes da implantação.
  3. Atribua a função Administrador ao serviço de build usando a guia Segurança no grupo de variáveis específico do ambiente.
  4. Marque a caixa ao lado de "implantar a infraestrutura do aplicativo Web" ao executar o pipeline do painel de controle de implantação.

Resumo das etapas necessárias para acessar o aplicativo Web depois de implantar o painel de controle:

  1. Atualize as URLs de resposta de registro do aplicativo.
  2. Atribua a função de leitor com o escopo da assinatura à identidade gerenciada atribuída pelo sistema do serviço de aplicativo.
  3. Execute o pipeline de implantação do aplicativo Web.
  4. (Opcionalmente) adicione uma política de acesso adicional ao serviço de aplicativo.

Implantar por meio da CLI do Azure (Cloud Shell)

Para obter instruções completas sobre como configurar o aplicativo Web usando a CLI do Azure, consulte Implantar o painel de controle

Resumo das etapas necessárias para configurar o aplicativo Web antes de implantar o painel de controle:

  1. Exporte as variáveis de ambiente TF_VAR_app_registration_app_id, TF_VAR_webapp_client_secret e TF_VAR_use_webapp="true".

Resumo das etapas necessárias para acessar o aplicativo Web depois de implantar o painel de controle:

  1. Atualize as URLs de resposta de registro do aplicativo.
  2. Atribua a função de leitor com o escopo da assinatura à identidade gerenciada atribuída pelo sistema do serviço de aplicativo.
  3. Gere um arquivo zip com base no código do aplicativo Web.
  4. Implante o software no serviço de aplicativo.
  5. Defina as configurações de aplicativo.
  6. (Opcionalmente) adicione uma política de acesso adicional ao serviço de aplicativo.

Usando o aplicativo Web

O aplicativo Web permite que você crie objetos de zona de carga de trabalho do SAP e objetos de infraestrutura do sistema. Esses objetos são, essencialmente, outra representação do arquivo de configuração do Terraform. Se estiver implantando usando o Azure Pipelines, você poderá implantar essas zonas de carga de trabalho e infraestruturas do sistema diretamente do aplicativo Web. Se estiver implantando usando a CLI do Azure, você poderá baixar o arquivo de parâmetro para qualquer objeto de sistema ou paisagem criado e usá-lo em nas implantações de linha de comando.

Criando um objeto de sistema ou paisagem do zero

  1. Navegue até a guia "Zonas de carga de trabalho" ou "Sistemas" na parte superior do site.
  2. Clique em "Criar" no canto inferior esquerdo.
  3. Preencha os parâmetros necessários nas guias "Básico" e "Avançado", bem como os parâmetros adicionais desejados.
  4. Determinados parâmetros serão listas suspensas preenchidas com recursos existentes do Azure.
    • Se nenhum resultado aparecer para uma lista suspensa, você provavelmente precisará especificar outra lista suspensa para ver qualquer opção. Ou confira a etapa 2 acima que aborda a identidade gerenciada atribuída pelo sistema.
      • O parâmetro de assinatura precisa ser especificado antes que qualquer outra funcionalidade da lista suspensa seja habilitada
      • O parâmetro network_arm_id precisa ser especificado antes que qualquer funcionalidade de lista suspensa de sub-rede seja habilitada
  5. Selecione enviar no canto inferior esquerdo

Criando uma zona de carga de trabalho ou um objeto do sistema com base em um arquivo

  1. Navegue até a guia "Arquivo" na parte superior do site.
  2. Suas opções são
    • Criar um arquivo do zero no navegador.
    • Importar um arquivo existing.tfvars e (opcionalmente) editá-lo antes de salvá-lo.
    • Usar um modelo existente e (opcionalmente) editá-lo antes de salvá-lo.
  3. Verifique se seu arquivo está em conformidade com as convenções de nomenclatura corretas.
  4. Ao lado do arquivo que gostaria de converter em uma zona de carga de trabalho ou objeto do sistema, clique em "Converter".
  5. A zona de carga de trabalho ou o objeto do sistema será exibido na respectiva guia.

Implantando uma zona de carga de trabalho ou um objeto do sistema (implantação de Pipelines do Azure DevOps)

  1. Navegue até a guia Zonas de carga de trabalho ou Sistemas.
  2. Ao lado da zona de carga de trabalho ou do sistema que gostaria de implantar, clique em "Implantar".
    • Se quiser implantar um arquivo, primeiro converta-o em uma zona de carga de trabalho ou objeto do sistema.
  3. Especifique os parâmetros necessários e confirme se o objeto está correto.
  4. Clique em implantar.
  5. O aplicativo Web gerará automaticamente um arquivo '.tfvars' com base no objeto, atualizará seu repositório do Azure DevOps e iniciará o pipeline de zona de carga de trabalho ou sistema (infraestrutura). Você pode monitorar a implantação no Portal do Azure DevOps.