Ambiente de runtime na Automação do Azure

Este artigo fornece uma visão geral sobre o ambiente de runtime, o escopo e os seus recursos.

Sobre o ambiente de runtime

O ambiente de runtime permite que você configure o ambiente de execução do trabalho e forneça a flexibilidade para escolher a linguagem de runtime e a versão de runtime de acordo com seus requisitos. Ele é a fonte de verdade única para definir e gerenciar o ambiente no qual um trabalho é executado. Cada runbook tem dois componentes:

• Código de script
• Ambiente de runtime – define a linguagem runtime, a versão de runtime e os pacotes necessários durante a execução do trabalho.

Você pode alterar esses componentes de forma independente, sem afetar uns aos outros.

Componentes do ambiente de runtime

O ambiente de runtime captura os seguintes detalhes sobre o ambiente de execução do trabalho:

• Linguagem - a linguagem de script direcionada para a execução do runbook. Por exemplo, PowerShell e Python.

• Versão do runtime - a versão da linguagem selecionada para a execução do runbook. Por exemplo: PowerShell 7.4 e Python 3.10.

• Pacotes – os pacotes consistem em assemblies e arquivos .dll que são importados e requisitados pelos runbooks para execução. Há dois tipos de pacotes com suporte para o ambiente de runtime.

  Tipos de pacote	Descrição
  Pacotes padrão	Os pacotes permitem que você gerencie recursos do Azure. Por exemplo, Az PowerShell 12.3.0, Azure CLI 2.64.0
  Pacotes fornecidos pelo cliente	Estes são pacotes personalizados que são exigidos por runbooks durante a execução. Os pacotes podem ser de: - Galeria pública: PSGallery, pypi - Autoria própria

Pacote da CLI do Azure no ambiente de runtime

Os comandos da CLI do Azure têm suporte em runbooks associados ao ambiente de runtime do PowerShell 7.4. A CLI do Azure versão 2.64.0 está disponível como um pacote padrão no ambiente de Runtime do PowerShell 7.4. A Automação do Azure acompanha de perto a cadência de lançamento de versões mais recentes da CLI do Azure e dá suporte a elas em runbooks.

Runbooks vinculados ao ambiente de execução do PowerShell 7.4 serão sempre executados com a versão mais recente da CLI do Azure compatível com a Automação do Azure. Da mesma forma, as versões declaradas de fim de suporte pela CLI do Azure do produto pai não seriam mais compatíveis com a Automação do Azure, pois elas poderiam potencialmente sofrer com bugs ou vulnerabilidades de segurança. Certifique-se de que os runbooks tenham sido projetados para ser executados perfeitamente em versões mais recentes da CLI do Azure.

Ambientes de runtime gerados pelo sistema

A Automação do Azure cria ambientes de Runtime gerados pelo sistema com base na linguagem de runtime, versão e pacotes/módulos presentes na interface antiga de sua conta de Automação do Azure. Há seis ambientes de runtime gerados pelo sistema:

• PowerShell-5.1
• PowerShell-7.1
• PowerShell-7.2
• Python-2.7
• Python-3.8
• Python-3.10

Não é possível editar esses ambientes de runtime. No entanto, as alterações feitas em Módulos/Pacotes para a conta da Automação são refletidas automaticamente nesses ambientes de runtime gerados pelo sistema.

Principais benefícios

• Controle granular – permite que você configure o ambiente de execução de script escolhendo a linguagem runtime, sua versão e módulos dependentes.
• Atualização de runbook – permite a fácil portabilidade de runbooks entre diferentes versões de execução, atualizando o ambiente de execução de runbooks para acompanhar as versões mais recentes do PowerShell e do Python. Você pode testar as atualizações antes de publicá-las para produção.
• Gerenciamento de módulo – permite testar a compatibilidade durante as atualizações do módulo e evitar alterações inesperadas que possam afetar a execução de seus cenários de produção.
• Funcionalidade de reversão – permite reverter facilmente o runbook para um ambiente de Runtime anterior. Caso uma atualização de runbook introduza problemas ou comportamento inesperado.
• Código simplificado – permite que você organize seu código facilmente vinculando runbooks a diferentes ambientes de Runtime sem a necessidade de criar várias contas de Automação.

Limitações

• O ambiente de runtime tem suporte atualmente em todas as regiões públicas, exceto Sudeste do Brasil e nuvens governamentais.
• O fluxo de trabalho do PowerShell, o PowerShell gráfico e os runbooks de fluxo de trabalho do PowerShell gráfico só funcionam com o ambiente de runtime do PowerShell-5.1 gerado pelo sistema.
• Runbooks criados na experiência de ambiente de runtime com a versão do runtime PowerShell 7.2+ serão exibidos como runbooks PowerShell 5.1 na experiência antiga.
• As permissões de RBAC não podem ser atribuídas ao ambiente de runtime.
• O ambiente de runtime não pode ser configurado por meio da extensão da Automação do Azure para Visual Studio Code.
• Ambientes de runtime excluídos não podem ser recuperados.
• Atualmente, esse recurso tem suporte por meio do portal do Azure e da API REST.
• Usar Pacotes: API REST para carregar pacotes personalizados.
• Não há suporte para o gerenciamento de módulos para a State Configuration de Automação do Azure por meio da experiência de ambiente de Runtime. Você pode continuar usando a experiência antiga para gerenciar módulos e pacotes para a State Configuration de Automação do Azure.

Alternar entre a experiência nova e a antiga

Embora a nova experiência de ambiente de runtime seja recomendada, você também pode alternar para a experiência padrão a qualquer momento. Saiba mais sobre como alternar entre as duas experiências.

Próximas etapas

• Para trabalhar com runbooks e ambiente de runtime, confira Gerenciar ambiente de runtime.
• Para obter detalhes do PowerShell, confira Documentos do PowerShell.