Perguntas frequentes sobre contêineres da IA do Azure

Perguntas gerais

O que está disponível?

Os contêineres de IA do Azure permitem que os desenvolvedores usem as mesmas APIs inteligentes disponíveis no Azure, mas com os benefícios da conteinerização. Alguns contêineres estão disponíveis como uma versão prévia restrita que pode exigir um aplicativo para acesso. Outros contêineres estão publicamente disponíveis como uma versão prévia não restrita ou estão em disponibilidade geral. Você pode encontrar uma lista completa de contêineres e sua disponibilidade no artigo Suporte a contêineres nos serviços de IA do Azure. Você também pode exibir os contêineres no MCR (Registro de Contêiner da Microsoft).

Há alguma diferença entre a nuvem de serviços de IA do Azure e os contêineres?

Os contêineres da IA do Azure são uma alternativa à nuvem dos serviços de IA do Azure. Os contêineres oferecem os mesmos recursos que os serviços de nuvem correspondentes. Os clientes podem implantar os contêineres no local ou no Azure. A tecnologia principal de IA, os tipos de preço, as chaves de API e a assinatura de API do contêiner e dos serviços de nuvem correspondentes são iguais. Existem recursos e os benefícios para escolher contêineres em vez do equivalente em serviço de nuvem.

Como acessar e usar um contêiner de versão prévia restrita?

Anteriormente, os contêineres de versão prévia restrita eram hospedados no repositório containerpreview.azurecr.io. A partir de 22 de setembro de 2020, esses contêineres são hospedados no Microsoft Container Registry. Baixá-los não exige que você use o comando docker login. Você poderá executar um contêiner de versão prévia restrita se o seu recurso do Azure tiver sido criado com a ID de assinatura aprovada do Azure. Não será possível executar o contêiner se a sua assinatura do Azure não for aprovada após o preenchimento do formulário de solicitação.

Os contêineres estarão disponíveis para todas as ofertas de serviços de IA do Azure e qual é o próximo conjunto de contêineres que devo esperar?

Gostaríamos de disponibilizar mais ofertas dos serviços de IA do Azure como contêineres. Fale com seu gerente de conta Microsoft local para obter atualizações sobre novas versões de contêiner e outros anúncios dos serviços de IA do Azure.

Qual é o SLA (contrato de nível de serviço) dos contêineres de IA do Azure?

Importante

Para saber mais sobre os contratos de nível de serviço para os serviços de IA do Azure, visite nossa página de SLA.

A IA do Azure fornece SLAs para serviços hospedados na nuvem que podem ser exibidos em nossa página de SLA.

No entanto, os serviços de IA do Azure em contêineres não oferecem um SLA, pois são softwares locais. Os clientes controlam as configurações de contêineres de recursos dos serviços de IA do Azure, portanto a Microsoft não pode oferecer um SLA para GA (disponibilidade geral). Os clientes são livres para implantar contêineres no local e definem os ambientes de host.

Esses contêineres estão disponíveis em nuvens soberanas?

Os contêineres Standard da IA do Azure podem ser usados nas nuvens soberanas. Os contêineres podem ser executados e conectados ao ponto de extremidade de cobrança nessas nuvens depois de autorizados, mas as imagens de contêineres devem ser extraídas do registro de contêineres da nuvem pública. Os contêineres que dependem de modelos de idioma baixados em runtime, como Tradutor ou Fala Personalizada em texto, também são configurados para extrair modelos de pontos de extremidade públicos.

Atualmente, não há suporte para a compra de contêineres desconectados em nuvens soberanas. Os contêineres desconectados adquiridos na nuvem pública, juntamente com todas as dependências, podem ser transferidos para as nuvens soberanas e executados na infraestrutura de nuvem soberana.

Controle de versão

Como os contêineres são atualizados para a versão mais recente?

Os clientes podem escolher quando atualizar os contêineres que eles implantaram. Os contêineres serão marcados com marcas de Docker padrão, como latest, para indicar a versão mais recente. Incentivamos os clientes a efetuar pull das versões mais recentes dos contêineres à medida que são lançados. Para obter detalhes sobre como ser notificado quando uma imagem for atualizada, consulte WebHooks do Registro de Contêiner do Azure.

Os arquivos de licença de contêiner são usados como chaves para descriptografar determinados arquivos em cada imagem de contêiner. Se esses arquivos criptografados forem atualizados em uma nova imagem de contêiner, o arquivo de licença que você tem poderá falhar ao iniciar o contêiner, mesmo que ele tenha funcionado com a versão anterior da imagem de contêiner. Para evitar esse problema, recomendamos que você baixe um novo arquivo de licença do ponto de extremidade do recurso para o contêiner fornecido no portal do Azure depois de efetuar pull de novas versões de imagem de mcr.microsoft.com.

Para baixar um novo arquivo de licença, você pode adicionar DownloadLicense=True ao comando executar docker juntamente com uma montagem de licença, sua Chave de API e seu ponto de extremidade de cobrança. Consulte a documentação do seu contêiner para obter instruções detalhadas.

Quais versões têm suporte?

Normalmente, só há suporte para a versão atual do contêiner. Incentivamos os clientes a se manterem atualizados para obter os patches e a tecnologia mais recentes.

Como é feito o controle de versão das atualizações?

As mudanças da versão principal indicam que há uma alteração interruptiva na assinatura da API. Prevemos que essa indicação geralmente coincidirá com as principais alterações de versão da oferta de nuvem dos serviços de IA do Azure correspondente. As mudanças de versões secundárias indicam correções de bug, atualizações de modelo ou novos recursos que não representam uma alteração interruptiva na assinatura de API.

Perguntas técnicas

Como posso diagnosticar possíveis erros em meu ambiente de implantação?

Se você estiver tendo problemas para executar um contêiner dos serviços de IA do Azure, tente usar o contêiner de diagnóstico da Microsoft. Use esse contêiner para diagnosticar erros comuns no ambiente de implantação que podem impedir que os contêineres de IA do Azure funcionem conforme o esperado.

Para obter o contêiner, use o seguinte comando docker pull:

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

Em seguida, execute o contêiner. Substitua {ENDPOINT_URI} pelo ponto de extremidade e {API_KEY} pela chave do recurso:

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

O contêiner testará a conectividade de rede com o ponto de extremidade de cobrança.

Como devo executar os contêineres da IA do Azure em dispositivos IoT?

Não importa se você não tem uma conexão confiável com a Internet, se quer economizar em custos de largura de banda, se tem requisitos de baixa latência ou se está lidando com dados confidenciais que precisam ser analisados no local, o Azure IoT Edge com contêineres da IA do Azure oferece consistência com a nuvem.

Esses contêineres são compatíveis com o OpenShift?

Nós não testamos contêineres com OpenShift, mas, em geral, deve ser possível executar os contêineres de IA do Azure nas plataformas que dão suporte a imagens do Docker. Se você está usando o OpenShift, recomendamos executar os contêineres como root-user.

Como fazer comentários e recomendações de recursos para o produto?

Incentivamos os clientes a expressar suas preocupações publicamente e a reagir a outras pessoas que fizeram o mesmo para problemas parecidos. É possível usar a ferramenta de comentários para comentar produtos e recomendar recursos.

Quais erros e mensagens de status os contêineres de IA do Azure exibem?

Veja as mensagens de status e os erros:

Status Descrição
Valid Sua chave de API é válida. Nenhuma ação é necessária.
Invalid Sua chave de API é inválida. Você deve informar uma chave de API válida para executar o contêiner. Localize a sua chave de API e a sua região de serviço no portal do Azure, na seção Chaves e Ponto de extremidade do recurso serviços de IA do Azure.
Mismatch Você informou uma chave de API ou um ponto de extremidade para um tipo diferente de recurso dos serviços de IA do Azure. Localize a sua chave de API e a sua região de serviço no portal do Azure, na seção Chaves e Ponto de extremidade do recurso serviços de IA do Azure.
CouldNotConnect O contêiner não pôde se conectar ao ponto de extremidade de cobrança. Verifique o valor Retry-After e aguarde o término desse período para fazer mais solicitações.
OutOfQuota A chave de API excedeu a cota. Você pode fazer upgrade de seu tipo de preço ou aguardar a disponibilidade de mais cotas. Localize o tipo no portal do Azure, na seção Tipo de preço do recurso dos serviços de IA do Azure.
BillingEndpointBusy O ponto de extremidade de cobrança está ocupado no momento. Verifique o valor Retry-After e aguarde o término desse período para fazer mais solicitações.
ContainerUseUnauthorized A chave de API informada não está autorizada para uso com esse contêiner. Provavelmente, você está usando um contêiner restrito. Verifique se a sua ID de assinatura do Azure foi aprovada enviando uma solicitação online.
[ERROR] Failed to download: context deadline exceeded A solicitação de download do arquivo modelo para nossos servidores atingiu o tempo limite. Verifique se você tem uma forte conexão com a Internet para baixar todos os arquivos necessários dentro de uma hora. Os downloads de modelos se aplicam à Tradução de Texto e a alguns contêineres do serviço de Fala.
The provided license path was not found. Please ensure a volume is mounted and a directory exists at the location specified by Mounts:License Somente contêineres desconectados. Não há nenhum arquivo de licença armazenado localmente no local especificado no comando docker run. Você pode ter montado o volume de licença incorretamente. Certifique-se de verificar seu sistema de arquivos local e fornecer um caminho de arquivo válido para o local de armazenamento local desejado para o arquivo de licença usando o argumento -v no comando docker run.
Unknown O servidor não pode processar solicitações de cobrança no momento.

Como fazer para obter suporte?

Os canais de suporte ao cliente são iguais aos das APIs com base em nuvem dos serviços de IA do Azure. Todos os contêineres de IA do Azure incluem recursos de registro em log que ajudam a nossa empresa e a comunidade a dar suporte aos clientes. Estas são as opções para obter mais suporte:

Como funciona a cobrança?

Os clientes são cobrados com base no consumo, semelhante à nuvem de serviços de IA do Azure. É necessário configurar os contêineres para enviar dados de medição ao Azure e as transações serão cobradas de acordo. Os recursos usados nos serviços hospedados e no local são adicionados à cota única com preços nivelados, contabilizados em ambos os usos. Para obter mais informações, consulte a seção de cobrança do contêiner que você está usando.

Importante

Os contêineres dos serviços de IA do Azure não estão licenciados para serem executados sem uma conexão ao Azure para medição. Os clientes precisam permitir que os contêineres sempre comuniquem as informações de cobrança com o serviço de medição. Os contêineres da IA do Azure não enviam dados de clientes para a Microsoft.

Este é um exemplo das informações de medição que um contêiner comunica:

usageRequestBody": {
  "id": "1234abcd-1234-56ab-ab12-1234abcd",
  "containerType": "<container-type>",
  "containerVersion": "<container-version>",
  "containerId": "<contianer-id>",
  "meter": {
    "name": "<meter-name>",
    "quantity": 0.0
  },
  "requestTime": 12345687890,
  "apiType": "<api-type>"
},

Qual é a garantia de suporte atual para contêineres?

A garantia padrão da Microsoft para software empresarial se aplica a todos os contêineres anunciados formalmente como GA (disponibilidade geral). Não há garantia para versões prévias.

O que acontece com os contêineres da IA do Azure quando se perde a conectividade com a Internet?

Os contêineres dos serviços de IA do Azure não estão licenciados para serem executados sem uma conexão ao Azure para medição. Os clientes precisam permitir que os contêineres sempre se comuniquem com o serviço de medição.

Por quanto tempo o contêiner pode operar sem estar conectado ao Azure?

Os contêineres dos serviços de IA do Azure não estão licenciados para serem executados sem uma conexão ao Azure para medição. Os clientes precisam permitir que os contêineres sempre se comuniquem com o serviço de medição.

Qual hardware é necessário para executar esses contêineres?

Os contêineres de IA do Azure se baseiam em x64 e podem executar qualquer nó do Linux, VM e dispositivo de borda compatível que dê suporte a contêineres do Linux Docker x64. Todos eles exigem processadores de CPU. Para obter mais informações, consulte a seção de requisitos e recomendações de contêiner do contêiner que você está usando.

No momento, esses contêineres são compatíveis com o Windows?

Os contêineres de IA do Azure são contêineres do Linux, mas, o Windows dá certo nível de suporte aos contêineres do Linux. Para saber mais sobre contêineres do Linux no Windows, confira a documentação do Docker.

Como os contêineres da IA do Azure se comparam às ofertas da AWS e do Google?

A Microsoft é o primeiro provedor de nuvem a mover seus modelos de IA pré-treinados em contêineres com cobrança simples por transação, como se os clientes estivessem usando um serviço de nuvem. A Microsoft acredita que uma nuvem híbrida oferece mais opções aos clientes.

Quais são as certificações de conformidade dos contêineres?

Os contêineres de IA do Azure não têm certificações de conformidade.

Em quais regiões os contêineres da IA do Azure estão disponíveis?

É possível executar contêineres em todo lugar, de qualquer região, mas eles precisam de uma chave e retornar ao Azure para fazer a medição. Todas as regiões compatíveis com o serviço de nuvem têm permissão para fazer a chamada de medição dos contêineres.