Editar

Perguntas frequentes sobre contêineres de 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 visualização fechada que pode exigir o acesso de um aplicativo. Outros recipientes estão disponíveis publicamente como uma visualização não ativada ou estão geralmente disponíveis. 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 Microsoft Container Registry (MCR).

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

Os contêineres de IA do Azure são uma alternativa à nuvem de 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 de IA principal, os níveis de preços, as chaves de API e a assinatura de API são os mesmos entre o contêiner e os serviços de nuvem correspondentes. Há recursos e benefícios para escolher contêineres em vez de seu equivalente de serviço de nuvem.

Como faço para acessar e usar um contêiner de visualização fechado?

Anteriormente, os contêineres de visualização fechados eram hospedados no containerpreview.azurecr.io repositório. A partir de 22 de setembro de 2020, esses contêineres serão hospedados no Microsoft Container Registry. Para baixá-los, você não precisa usar o docker login comando. Você pode executar um contêiner de visualização fechado se seu recurso do Azure tiver sido criado com a ID de assinatura do Azure aprovada. Você não poderá executar o contêiner se sua assinatura do Azure não tiver sido aprovada após a conclusão 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 de serviços de IA do Azure como contêineres. Entre em contato com seu gerente de conta da Microsoft local para obter atualizações sobre novas versões de contêiner e outros anúncios de serviços de IA do Azure.

O que é o contrato de nível de serviço (SLA) para contêineres de IA do Azure?

Importante

Para saber mais sobre contratos de nível de serviço para 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 fornecem um SLA, pois é um software local. Os clientes controlam as configurações de contêiner de recursos dos serviços de IA do Azure, portanto, a Microsoft não pode oferecer um SLA para disponibilidade geral (GA). Os clientes são livres para implantar contêineres no local e definir os ambientes host.

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

Os contêineres padrão de IA do Azure podem ser usados nas nuvens soberanas. Os contêineres podem ser executados e se conectar ao ponto de extremidade de faturamento nessas nuvens depois de autorizados, mas as imagens de contêiner devem ser extraídas do registro de contêiner de nuvem pública. Os contêineres que dependem de modelos de linguagem baixados em tempo de execução, como Translator ou Custom Speech to text, também são configurados para extrair modelos de pontos de extremidade públicos.

Atualmente, a compra de contêineres desconectados não é suportada nas nuvens soberanas. Os contêineres desconectados comprados na nuvem pública, juntamente com todas as dependências, podem ser transferidos para nuvens soberanas e executados na infraestrutura de nuvem soberana.

Controlo 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 implantaram. Os contêineres são marcados com tags padrão do Docker, como latest para indicar a versão mais recente. Incentivamos os clientes a retirar as versões mais recentes dos contentores à medida que são lançados. Para obter detalhes sobre como ser notificado quando uma imagem é atualizada, consulte Webhooks do Registro de Contêiner do Azure.

Os ficheiros de licença de contentor são usados como chaves para desencriptar determinados ficheiros dentro de cada imagem de contentor. Se esses arquivos criptografados forem atualizados dentro de uma nova imagem de contêiner, o arquivo de licença que você tem pode falhar ao iniciar o contêiner, mesmo que 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 de recurso para seu contêiner fornecido no portal do Azure depois de extrair novas versões de imagem do mcr.microsoft.com.

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

Que versões são suportadas?

Geralmente, apenas a versão atual do contêiner é suportada. Incentivamos os clientes a manterem-se atualizados para obter os patches e a tecnologia mais recentes.

Como as atualizações são versionadas?

As principais alterações de versão indicam que há uma alteração significativa na assinatura da API. Prevemos que essa indicação geralmente coincidirá com as principais alterações de versão na oferta de nuvem de serviços de IA do Azure correspondente. Pequenas alterações de versão indicam correções de bugs, atualizações de modelo ou novos recursos que não fazem uma alteração significativa na assinatura da API.

Questões técnicas

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

Se você estiver tendo problemas para executar um contêiner de serviços de IA do Azure, tente usar o contêiner de diagnóstico da Microsoft. Use esse contêiner para diagnosticar erros comuns em seu 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 docker pull comando:

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

Em seguida, execute o contêiner. Substitua {ENDPOINT_URI} pelo ponto de extremidade e substitua {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 faturamento.

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

Quer não tenha uma ligação fiável à Internet, pretenda poupar no custo da largura de banda, tenha requisitos de baixa latência ou esteja a lidar com dados confidenciais que precisam de ser analisados no local, o Azure IoT Edge com contentores de IA do Azure proporciona-lhe consistência com a nuvem.

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

Não testamos contêineres com o OpenShift, mas, geralmente, os contêineres de IA do Azure devem ser executados em qualquer plataforma que ofereça suporte a imagens do Docker. Se você estiver usando o OpenShift, recomendamos executar os contêineres como root-user.

Como faço para fornecer feedback sobre produtos e recomendações de recursos?

Encorajamos os clientes a expressarem as suas preocupações publicamente e a votarem favoravelmente outros que tenham feito o mesmo quando os potenciais problemas se sobrepõem. Você pode usar a ferramenta de feedback para comentários sobre produtos e recomendações de recursos.

Quais mensagens de status e erros os contêineres do Azure AI retornam?

Aqui estão as mensagens de status e erros:

Status Description
Valid Sua chave de API é válida. Não é necessária nenhuma ação.
Invalid Sua chave de API é inválida. Você deve fornecer uma chave de API válida para executar o contêiner. Encontre sua chave de API e região de serviço no portal do Azure, na seção Chaves e Ponto de Extremidade do seu recurso de serviços de IA do Azure.
Mismatch Você forneceu uma chave de API ou ponto de extremidade para um tipo diferente de recurso de serviços de IA do Azure. Encontre sua chave de API e região de serviço no portal do Azure, na seção Chaves e Ponto de Extremidade do seu recurso de serviços de IA do Azure.
CouldNotConnect O contêiner não pôde se conectar ao ponto de extremidade de faturamento. Verifique o Retry-After valor e aguarde que este período termine antes de fazer mais pedidos.
OutOfQuota A chave da API excedeu a cota. Você pode atualizar seu nível de preço ou aguardar que mais cotas fiquem disponíveis. Encontre sua camada no portal do Azure, na seção Camada de Preço do seu recurso de serviço de IA do Azure.
BillingEndpointBusy O ponto de extremidade de faturamento está ocupado no momento. Verifique o Retry-After valor e aguarde que este período termine antes de fazer mais pedidos.
ContainerUseUnauthorized A chave de API fornecida não está autorizada para uso com esse contêiner. Você provavelmente está usando um contêiner fechado, portanto, certifique-se de que sua ID de assinatura do Azure seja aprovada enviando uma solicitação online.
[ERROR] Failed to download: context deadline exceeded A solicitação de download do arquivo de modelo para nossos servidores expirou. Certifique-se de que tem uma ligação à Internet forte para transferir todos os ficheiros necessários no prazo de uma hora. Os downloads de modelos aplicam-se à 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 da 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 No momento, o servidor não consegue processar solicitações de faturamento.

Como posso obter suporte?

Os canais de suporte ao cliente são os mesmos das APIs baseadas 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 nós e à comunidade a dar suporte aos clientes. Aqui estão as opções para mais suporte:

Como funciona a faturação?

Os clientes são cobrados com base no consumo, semelhante à nuvem de serviços de IA do Azure. Os contêineres precisam ser configurados para enviar dados de medição para o Azure, e as transações são cobradas de acordo. Os recursos usados nos serviços hospedados e locais são adicionados à cota única com preços diferenciados, contando com ambos os usos. Para obter mais informações, consulte a seção de faturamento do contêiner que você está usando.

Importante

Os contêineres de IA do Azure não são licenciados para serem executados sem estarem conectados ao Azure para medição. Os clientes precisam permitir que os contêineres sempre comuniquem informações de faturamento com o serviço de medição. Os contêineres de IA do Azure não enviam dados do cliente para a Microsoft.

Veja um exemplo das informações que um contêiner comunica para medição:

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 aplica-se a todos os contentores formalmente anunciados como geralmente disponíveis (GA). Não há garantia para pré-visualizações.

O que acontece aos contentores de IA do Azure quando a conectividade com a Internet é perdida?

Os contêineres de IA do Azure não são licenciados para serem executados sem estarem conectados 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 de IA do Azure não são licenciados para serem executados sem estarem conectados ao Azure para medição. Os clientes precisam permitir que os contêineres sempre se comuniquem com o serviço de medição.

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

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

Esses contêineres são atualmente suportados no Windows?

Os contêineres de IA do Azure são contêineres Linux, mas há algum suporte para contêineres Linux no Windows. Para obter mais informações sobre contêineres Linux no Windows, consulte a documentação do Docker.

Como os contêineres de 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 aos clientes mais escolha.

Que certificações de conformidade têm os contentores?

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

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

Os contêineres podem ser executados em qualquer lugar em qualquer região, mas eles precisam de uma chave e precisam ligar de volta para o Azure para medição. Todas as regiões suportadas para o serviço de nuvem são suportadas para a chamada de medição dos contêineres.