Implantar e executar contêineres em uma Instância de Contêiner do Azure

Artigo
09/03/2024

Com as etapas a seguir, dimensione com facilidade os aplicativos dos serviços de IA do Azure na nuvem com as Instâncias de Contêiner do Azure. A conteinerização ajuda você a se concentrar em criar seus aplicativos em vez de gerenciar a infraestrutura. Para obter mais informações sobre como usar contêineres, confira Recursos e benefícios.

Pré-requisitos

A receita funciona com qualquer contêiner de serviços de IA do Azure. O recurso dos serviços de IA do Azure precisa ser criado antes que a receita seja usada. Cada serviço de IA do Azure que dá suporte a contêineres tem um artigo "Como instalar" sobre como instalar e configurar o serviço para um contêiner. Alguns serviços exigem um arquivo ou um conjunto de arquivos como entrada para o contêiner. É importante que você entenda e tenha usado o contêiner com êxito antes de usar essa solução.

Um recurso do Azure para o serviço de IA do Azure que você está usando.
URL do ponto de extremidade de recurso de serviço de IA do Azure: examine o artigo "Como instalar" do seu serviço específico para o contêiner para descobrir o local de origem da URL do ponto de extremidade no portal do Azure e a aparência de um exemplo correto da URL. O formato exato pode variar conforme o serviço.
Chave do serviço de IA do Azure: as chaves estão na página Chaves do recurso do Azure. Você precisa apenas de uma das duas chaves. A chave é uma cadeia de 32 caracteres alfanuméricos.
Um contêiner individual dos serviços de IA do Azure no host local (seu computador). Verifique se você pode:
- Efetuar pull da imagem com um comando docker pull.
- Executar o contêiner local com êxito com todas as definições de configuração necessárias com um comando docker run.
- Chamar o ponto de extremidade do contêiner obtendo uma resposta HTTP 2xx e uma resposta JSON novamente.

Todas as variáveis entre colchetes angulares, <>, precisam ser substituídas por valores próprios. Essa substituição inclui os colchetes angulares.

Importante

O contêiner do LUIS exige um arquivo de modelo .gz que é extraído em runtime. O contêiner precisa conseguir acessar esse arquivo de modelo por meio de uma montagem de volume da instância de contêiner. Para carregar um arquivo de módulo, siga estas etapas:

Criar um compartilhamento de arquivo do Azure. Anote o nome da conta do Armazenamento do Azure, a chave e o nome do compartilhamento de arquivo, pois você precisará deles mais tarde.
exporte seu modelo do LUIS (aplicativo empacotado) do portal do LUIS.
No portal do Azure, acesse a página Visão geral do recurso da conta de armazenamento e selecione Compartilhamentos de arquivos.
Selecione o nome do compartilhamento de arquivo que você criou recentemente e escolha Carregar. Em seguida, carregue o aplicativo empacotado.

Azure portal
CLI

Criar um recurso de instância de contêiner do Azure usando o portal do Azure

Vá para a página Criar para instâncias de contêiner.

Na guia Informações básicas, insira os seguintes detalhes:

Configuração	Valor
Subscription	Selecione sua assinatura.
Resource group	Selecione o grupo de recursos disponível ou crie um novo, como `cognitive-services`.
Nome do contêiner	Insira um nome, como `cognitive-container-instance`. O nome deve estar em letras minúsculas.
Localização	Selecione uma região para implantação.
Tipo de imagem	Se a imagem de contêiner estiver armazenada em um registro de contêiner que não requeira credenciais, escolha `Public`. Se o acesso à imagem de contêiner requerer credenciais, escolha `Private`. Consulte repositórios e imagens de contêiner para obter detalhes sobre se a imagem de contêiner é `Public` ou `Private` ("Visualização pública").
Nome da imagem	Insira o local do contêiner de serviços de IA do Azure. O local é aquele usado como um argumento para o comando `docker pull`. Consulte os repositórios e imagens de contêiner para obter os nomes de imagem disponíveis e seu repositório correspondente. O nome da imagem deve ser totalmente qualificado, especificando três partes. Primeiro, o registro de contêiner, em seguida, o repositório e, por fim, o nome da imagem: `<container-registry>/<repository>/<image-name>`. Segue um exemplo: `mcr.microsoft.com/azure-cognitive-services/keyphrase` representaria a imagem de Extração de Frases-chave no Registro de Contêiner do Azure no repositório dos serviços de IA do Azure. Outro exemplo é, `containerpreview.azurecr.io/microsoft/cognitive-services-speech-to-text` que representaria a imagem de Conversão de fala em texto no repositório da Microsoft do registro de contêiner da versão preliminar do contêiner.
Tipo do SO	`Linux`
Tamanho	Altere o tamanho para as recomendações sugeridas para o seu contêiner específico de IA do Azure: 2 núcleos de CPU 4 GB

Na guia Rede, insira os seguintes detalhes:

Configuração Valor

Portas Defina a porta TCP como 5000. Expõe o contêiner na porta 5000.

Configuração	Valor
Portas	Defina a porta TCP como `5000`. Expõe o contêiner na porta 5000.

Na guia Avançado, insira as variável de ambiente necessárias para as configurações de cobrança de contêiner do recurso de instância de contêiner do Azure:

Chave	Valor
`ApiKey`	Copiado da página Chaves e ponto de extremidade do recurso. É uma cadeia de caracteres alfanumérica de 32 caracteres sem espaços ou traços, `xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`.
`Billing`	Sua URL de ponto de extremidade copiada da página Chaves e ponto de extremidade do recurso.
`Eula`	`accept`

Selecione Examinar e criar
Após a aprovação da validação, clique em Criar para concluir o processo de criação
Quando o recurso for implantado com êxito, ele estará pronto

Crie um recurso de instância de contêiner do Azure a partir do CLI do Azure

O YAML abaixo define o recurso de instância de contêiner do Azure. Copie e cole o conteúdo em um novo arquivo, chamado my-aci.yaml e substitua os valores comentados pelos seus próprios. Confira o formato de modelo para YAML válido. Confira os repositórios e imagens de contêiner para obter os nomes de imagem disponíveis e seu repositório correspondente. Para obter mais informações sobre a referência do YAML para instâncias de contêiner, confira Referência do YAML: instâncias de contêiner do Azure.

apiVersion: 2018-10-01
location: # < Valid location >
name: # < Container Group name >
properties:
  imageRegistryCredentials: # This is only required if you are pulling a non-public image that requires authentication to access. For example Text Analytics for health.
  - server: containerpreview.azurecr.io
    username: # < The username for the preview container registry >
    password: # < The password for the preview container registry >
  containers:
  - name: # < Container name >
    properties:
      image: # < Repository/Image name >
      environmentVariables: # These env vars are required
        - name: eula
          value: accept
        - name: billing
          value: # < Service specific Endpoint URL >
        - name: apikey
          value: # < Service specific API key >
      resources:
        requests:
          cpu: 4 # Always refer to recommended minimal resources
          memoryInGb: 8 # Always refer to recommended minimal resources
      ports:
        - port: 5000
  osType: Linux
  volumes: # This node, is only required for container instances that pull their model in at runtime, such as LUIS.
  - name: aci-file-share
    azureFile:
      shareName: # < File share name >
      storageAccountName: # < Storage account name>
      storageAccountKey: # < Storage account key >
  restartPolicy: OnFailure
  ipAddress:
    type: Public
    ports:
    - protocol: tcp
      port: 5000
tags: null
type: Microsoft.ContainerInstance/containerGroups

Observação

Nem todos os locais têm a mesma disponibilidade de CPU e memória. Confira a tabela de locais e recursos para obter a listagem de recursos disponíveis para contêineres por local e sistema operacional.

Vamos usar o arquivo YAML que criamos no comando az container create. No CLI do Azure, execute o comando az container create substituindo <resource-group> pelo seu próprio. Além disso, para proteger valores em uma implantação do YAML, confira valores seguros.

az container create -g <resource-group> -f my-aci.yaml

A saída do comando será Running..., se válida, e após algum tempo será alterada para uma cadeia de caracteres JSON representando o recurso ACI recém-criado. Provavelmente a imagem de contêiner não estará disponível por algum tempo, mas o recurso estará implantado.

Dica

Preste muita atenção nos locais de visualização pública de ofertas dos serviços de IA do Azure, porque o YAML precisará ser ajustado adequadamente para corresponder ao local.

Selecione a Visão geral e copie o endereço IP. Ele será um endereço IP numérico, como 55.55.55.55.
Abra uma nova guia do navegador e use o endereço IP, por exemplo, http://<IP-address>:5000 (http://55.55.55.55:5000). Você verá a home page do contêiner, informando que o contêiner está em execução.
Selecione Descrição da API de Serviço para ver a página do Swagger referente ao contêiner.
Escolha uma das APIs POST e selecione Experimentar. Os parâmetros serão exibidos, incluindo a entrada. Preencha os parâmetros.
Selecione Executar para enviar a solicitação para a instância de contêiner.

Você criou e usou com êxito contêineres de IA do Azure na Instância de Contêiner do Azure.

Validar se um contêiner está em execução

Há várias maneiras de validar se um contêiner está em execução. Localize o endereço IP externo e a porta exposta do contêiner em questão e abra seu navegador da Web favorito. Use as várias URLs de solicitação a seguir para validar se o contêiner está em execução. Os exemplos de URLs de solicitação listados aqui são http://localhost:5000, mas seu contêiner específico poderá variar. Dependa do endereço IP externo do seu contêiner e da porta exposta.

URL de Solicitação	Finalidade
`http://localhost:5000/`	O contêiner fornece uma home page.
`http://localhost:5000/ready`	Solicitada com GET, essa URL fornece uma verificação que indica que o contêiner está pronto para aceitar uma consulta no modelo. Essa solicitação pode ser usada para testes de preparação e de execução do Kubernetes.
`http://localhost:5000/status`	Também solicitada com GET, essa URL verifica se a chave API usada para iniciar o contêiner é válida sem causar uma consulta de ponto de extremidade. Essa solicitação pode ser usada para testes de preparação e de execução do Kubernetes.
`http://localhost:5000/swagger`	O contêiner fornece um conjunto completo de documentação para os pontos de extremidade e um recurso Experimentar. Com esse recurso, é possível inserir suas configurações em um formulário HTML baseado na Web e realizar a consulta sem precisar escrever nenhum código. Após a consulta ser retornada, um exemplo de comando CURL será fornecido para demonstrar o formato do corpo e dos cabeçalhos HTTP exigidos.

Home page do contêiner

Observação

Se estiver executando a Análise de Texto para o contêiner de integridade, use a seguinte URL para enviar consultas: http://localhost:5000/text/analytics/v3.2-preview.1/entities/health

Compartilhar via