Um instant service é a unidade de faturamento e permissão no PAI-Instant Service. Um template define o ambiente de execução das instâncias. Este tópico descreve como criar e gerenciar instant services (incluindo acesso ao workbench) e templates (a partir de uma imagem, de uma instância ou de um template público).
Visão geral
O PAI-Instant Service utiliza uma estrutura de recursos de três níveis: Instant Service → Template → Instance. Este tópico aborda o gerenciamento dos dois primeiros níveis. O fluxo de trabalho geral é:
Criação do instant service pelo administrador: Crie um instant service, selecione o modo de saída de rede, o tipo de recurso e, opcionalmente, o repositório de imagens.
Criação do template pelo administrador ou desenvolvedor: Defina um ambiente de execução dentro do instant service — a partir de uma imagem, de uma instância ou de um template público.
Uso das instâncias pelos usuários finais: Inicie instâncias a partir de templates. Para mais detalhes, consulte Manage Instant Service instances.
Para conhecer o modelo completo de recursos de três níveis, consulte Instant Service overview — Resource hierarchy.
Criar um instant service
Faça login no PAI console.
No painel de navegação à esquerda, selecione Elastic Algorithm Service (EAS) para acessar a página da lista de services.
Acesse a aba Instant Service na parte superior.
Clique em Create Instant Service para acessar a página de criação.
-
Configure os seguintes parâmetros:
Parâmetro
Descrição
Name
Obrigatório. Aceita letras minúsculas, dígitos e sublinhados. Deve começar com uma letra minúscula. Máximo de 36 caracteres.
Resource Type
Obrigatório. Selecione o ID do grupo de recursos para o Instant Service em EAS Resource Group.
Enterprise Edition Image Instance
Opcional. Necessário apenas para criar templates a partir de imagens personalizadas.
-
Selecione uma instância ACR Enterprise Edition Standard ou Premium em sua conta. Os templates farão pull de imagens desse repositório. Caso ainda não tenha criado um repositório ACR, clique no link na página para acessar o console do ACR e criar um.
-
Se utilizar apenas templates públicos, deixe este campo em branco.
Custom Authentication
Opcional. Quando ativado, permite definir um token personalizado para autenticação da API do service. Quando desativado, o sistema gera um token padrão automaticamente.
Network Egress Mode
Obrigatório. O padrão é Shared Public Network.
-
Dedicated VPC: Connects the service to your VPC for internet access via your configured NAT gateway. Suitable for accessing corporate intranet resources and using custom security groups and network policies.
-
Isolated Mode: Instant services cannot access any external networks, making them suitable for tasks such as sensitive data processing and compliance isolation.
-
Shared Public Network: Instant services access the internet through the platform's public gateway, allowing you to quickly set up a test environment without configuring a VPC. This mode uses shared bandwidth among multiple users, provides no SLA or bandwidth stability guarantees, and charges no public traffic fees.
-
Clique em Confirm para concluir a criação.
Acessar o workbench do instant service
Após a criação, visualize as instâncias existentes na lista da aba Instant Service.
Na coluna Invoke, clique no ícone Instant Service Workbench. A caixa de diálogo Go to Instant Service Workbench será exibida com dois tipos de links de acesso:
|
Tipo de link |
Finalidade |
Escopo de permissão |
|
Manage Links |
Gerenciamento completo do instant service, templates e instâncias |
Criar, visualizar e excluir templates e instâncias |
|
Read-only Link |
Visualização da configuração e informações de monitoramento do instant service, templates e instâncias |
Somente visualização — criação e exclusão indisponíveis |
Tanto os Manage Links quanto o Read-only Link são acessíveis pela rede pública. Os links têm validade de 12 horas. Gere um novo link após a expiração. Armazene esses links com segurança e não os compartilhe com usuários não autorizados.
Copie a URL dos Manage Links ou do Read-only Link e abra-a em um navegador para acessar o workbench do instant service.
Ações do workbench
O workbench do instant service oferece quatro ações principais:
Create template: Crie um novo template no instant service atual.
Create instance: Inicia uma instância a partir de um template existente.
Open monitoring: Acesse o painel do Grafana para visualizar métricas do instant service no nível do service.
Share: Gera e copia um link de acesso ao workbench para compartilhar com membros da equipe.
Informações do workbench
O workbench do instant service exibe os seguintes detalhes:
Informações do instant service: Quantidade de templates, total de instâncias e instâncias em execução.
Configuração de rede: ID da VPC, ID do vSwitch e ID do grupo de segurança.
Informações da conta: ID do usuário RAM e ID da conta Alibaba Cloud.
Informações da imagem: Endereço do repositório de imagens.
O workbench do instant service também fornece as seguintes visualizações:
Private templates: Todos os templates criados pelo usuário no instant service atual.
Public templates: Templates públicos fornecidos pela plataforma. Para mais detalhes, consulte Usar templates públicos.
Instance list: Todas as instâncias em execução ou pausadas no instant service atual.
Criar um template
Um template define o ambiente de execução das instâncias, incluindo a imagem, o comando de inicialização e as especificações de recursos. Um instant service pode ter múltiplos templates para diferentes ambientes de execução.
É necessário configurar uma Enterprise Edition Image Instance (edição Standard ou Premium) durante a criação do instant service para criar templates.
Passos
No canto superior direito do workbench do instant service, clique em Create template.
-
No painel Create new template que se abre à direita, configure os seguintes parâmetros:
Parâmetro
Obrigatório
Descrição
Nome do template
Sim
O sistema gera um nome padrão. Você pode personalizá-lo.
Descrição do template
Não
Descrição da finalidade do template. Máximo de 100 bytes.
Token personalizado
Não
Se deixado em branco, o sistema gera um token automaticamente para autenticação da instância.
Método de criação
Sim
Suporta From image, From instance e From public template. Para mais detalhes, consulte Three creation methods abaixo.
Clique em Create template. O template entra no estado de construção. Após a conclusão, o status muda para Ready.
Três métodos de criação
A partir de imagem
Crie um template a partir de uma imagem de contêiner. Utilize este método quando tiver uma imagem de execução padronizada. Configure o seguinte:
Endereço da imagem: Obrigatório. Insira o endereço completo da imagem do seu repositório ACR.
Comando de inicialização: Comando de entrada executado ao iniciar a instância.
-
Comando de prontidão: Comando de verificação de integridade executado após o início da instância.
Exemplo : Se o seu service executa na porta 8000, verifique se ele está totalmente pronto antes de criar o template. Defina o comando de prontidão como
curl -f http://localhost:8000para verificar o código de status HTTP. Configuração de recursos: Núcleos de CPU, memória (MiB), disco (GiB) e tempo limite (segundos). Padrão: 2 núcleos / 2.000 MiB / 30 GiB / 3.600 segundos.
Variáveis de ambiente: Pares chave-valor visíveis dentro da instância.
A partir de instância
Salve o estado completo de uma instância como um novo template, incluindo arquivos gravados, dependências instaladas e processos em execução. Insira o Instance ID. Para mais detalhes, consulte Manage instances — Save as template.
A partir de template público
Salve um template público em sua instância ACR empresarial para melhorar o desempenho e a confiabilidade do pull de imagens. Selecione o public template desejado.
Visualizar detalhes do template
Na aba Private templates ou Public templates do workbench, clique em um ID de template para abrir sua página de detalhes.
Ações
Visualizar informações de conexão SDK: Clique em SDK Access para ver a configuração de conexão e exemplos de código Python para chamada via E2B SDK. Copie a configuração com um clique.
Abrir monitoramento: Acesse o painel do Grafana no nível do template.
Compartilhar: Gere e copie um link de acesso para este template.
Criar instância: Inicie uma nova instância a partir deste template.
Detalhes do template
A página de detalhes do template inclui:
Informações básicas: ID do template, versão do ENVD, token de API, hora de criação, hora da última atualização, ID do usuário RAM e ID da conta Alibaba Cloud.
Especificações de recursos: CPU, memória e disco.
Variáveis de ambiente: Lista de pares chave-valor.
Endereço do repositório: Repositório de imagens ACR associado a este template.
Informações de construção: Tipo de construção (por exemplo, a partir de imagem), imagem de source, comando de inicialização e comando de prontidão.
Lista de instâncias: Todas as instâncias criadas a partir deste template.
Próximos passos
Iniciar e usar instâncias a partir de templates: Manage Instant Service instances
Criar e chamar instâncias por meio do SDK: E2B SDK integration
Escolha um template público para o seu cenário: Use public templates