Conectar-se aos serviços nos Aplicativos de Contêiner do Azure (versão prévia)
À medida que você desenvolve aplicativos nos Aplicativos de Contêiner do Azure, muitas vezes você precisa se conectar a diferentes serviços. Em vez de criar serviços antecipadamente e conectá-los manualmente ao seu aplicativo de contêiner, você pode criar rapidamente instâncias de serviços de nível de desenvolvimento projetados para ambientes de não produção conhecidos como complementos.
Os complementos permitem que você use serviços de OSS sem o peso de downloads, criação e configuração manuais.
Quando estiver pronto para que seu aplicativo use um serviço de nível de produção, você poderá conectar seu aplicativo a um serviço gerenciado do Azure.
Os serviços disponíveis como complemento incluem:
| Título | Nome do serviço |
|---|---|
| Kafka | kafka |
| MariaDB | mariadb |
| Milvus | milvus |
| PostgreSQL (software livre) | postgres |
| Qdrant | qdrant |
| Redis (software livre) | redis |
| Weaviate | weaviate |
Você pode obter a lista mais recente de serviços de complemento executando o seguinte comando:
az containerapp add-on --help
Confira a seção sobre como gerenciar um serviço para obter instruções de uso.
Recursos
Os complementos vêm com os seguintes recursos:
- Escopo: o complemento é executado no mesmo ambiente que o aplicativo de contêiner conectado.
- Dimensionamento: o complemento pode ser dimensionado em zero quando não há demanda para o serviço.
- Preços: a cobrança do complemento está abaixo dos preços baseados no consumo. A cobrança só acontece quando as instâncias do complemento estão em execução.
- Armazenamento: o complemento usa armazenamento persistente para garantir que não haja perda de dados, pois o complemento é dimensionado em zero.
- Revisões: sempre que você altera um complemento, uma nova revisão do aplicativo de contêiner é criada.
Confira os recursos específicos do serviço para serviços gerenciados.
Associação
Os complementos e os serviços gerenciados se conectam a um contêiner por meio de uma associação.
O runtime dos Aplicativos de Contêiner associa um aplicativo de contêiner a um serviço:
- Descobrir o serviço
- Extrair valores de configuração de rede e conexão
- Injetar informações de configuração e conexão em variáveis de ambiente de aplicativo de contêiner
Depois que uma associação é estabelecida, o aplicativo contêiner pode ler esses valores de configuração e conexão de variáveis de ambiente.
Desenvolvimento versus produção
À medida que você passa do desenvolvimento para a produção, você pode passar de um complemento para um serviço gerenciado.
A tabela a seguir mostra qual serviço usar no desenvolvimento e qual serviço usar em produção.
| Funcionalidade | Adicionar | Serviço gerenciado de produção |
|---|---|---|
| Cache | Redis de software livre | Cache Redis do Azure |
| Banco de dados | N/D | Azure Cosmos DB |
| Banco de dados | PostgreSQL de software livre | Banco de Dados do Azure para PostgreSQL Servidor Flexível |
Você é responsável pela continuidade de dados entre ambientes de desenvolvimento e produção.
Gerenciar um serviço
Para conectar um serviço a um aplicativo, primeiro você precisa criar o serviço.
Use o comando az containerapp add-on <SERVICE_TYPE> create com o tipo de serviço e o nome para criar um novo serviço.
az containerapp add-on redis create \
--name myredis \
--environment myenv
Esse comando cria um novo serviço Redis chamado myredis em um ambiente de Aplicativos de Contêiner chamado myenv.
Para associar um serviço a um aplicativo, use o argumento --bind para containerapp create.
az containerapp create \
--name myapp \
--image myimage \
--bind myredis \
--environment myenv
Esse comando apresenta o típico aplicativo de contêiner create com o argumento --bind. O argumento bind informa ao runtime dos Aplicativos de Contêiner para conectar um serviço ao aplicativo.
O argumento --bind está disponível para os comandos create ou update.
Para desconectar um serviço de um aplicativo, use o argumento --unbind no comando update
O exemplo a seguir mostra como desassociar um serviço.
az containerapp update --name myapp --unbind myredis
Para obter um tutorial completo sobre como se conectar aos serviços, confira Serviços do Connect nos Aplicativos de Contêiner do Azure.
Para obter mais informações sobre os comandos e argumentos de serviço, confira a referência az containerapp.
Limitações
- Os complementos estão em versão prévia pública.
- Qualquer aplicativo de contêiner criado antes de 23 de maio de 2023 não está qualificado para usar complementos.
- Os complementos vêm com garantias mínimas. Por exemplo, eles serão reiniciados automaticamente se falharem, no entanto, não há nenhuma qualidade formal de serviço ou garantias de alta disponibilidade associadas a eles. Para cargas de trabalho de produção, use serviços gerenciados pelo Azure.
- Se você usar sua própria VNET, deverá usar um ambiente de perfis de carga de trabalho. O recurso Complementos não tem suporte apenas em ambientes de consumo que usam VNETs personalizadas.