Implemente o Data API builder em ambientes isolados da rede

Este guia mostra-lhe como instalar e executar o Data API Builder (DAB) em ambientes sem acesso à internet. As implementações isoladas são comuns nos setores da saúde, defesa, finanças, energia e marítimo, onde a conectividade de rede de saída é restrita ou proibida.

Pré-requisitos

• Uma máquina com acesso à internet para descarregar pacotes (a máquina de "staging").
• A máquina de destino sem ligação à rede, com um sistema operativo suportado.
• Um método para transferir ficheiros entre máquinas (pen USB, transferência de ficheiros aprovada, etc.).

Passo 1: Descarregar pacotes na máquina de encenação

Numa máquina com acesso à internet, descarregue todos os pacotes necessários.

Descarregar o runtime de .NET

Descarregue o arquivo binário de execução ASP.NET Core .NET 9.0 para o seu sistema operativo de destino a partir da página de download .NET. Escolha o arquivo binário ASP.NET Core Runtime (.tar.gz para Linux, .zip para Windows), não o instalador ou SDK.

Descarregar o pacote construtor de APIs de Dados

Use dotnet tool install com --tool-path para descarregar DAB e todas as suas dependências para um diretório portátil:

dotnet tool install --tool-path ./dab-tool Microsoft.DataApiBuilder

Este comando cria um diretório de ferramentas autónomo com todos os ficheiros necessários.

Passo 2: Transfira ficheiros para a máquina isolada

Copie estes itens para a máquina alvo:

• O arquivo binário do ASP.NET Core Runtime (.zip ou .tar.gz)
• O dab-tool diretório que contém a ferramenta DAB e todas as dependências

Passo 3: Instalar na máquina isolada da rede

Instalar o ambiente de execução .NET

Extrair o arquivo binário de execução. Não é necessário instalar nem acesso à internet.

Expand-Archive -Path "aspnetcore-runtime-9.0.x-win-x64.zip" -DestinationPath "C:\dotnet"
$env:DOTNET_ROOT = "C:\dotnet"
$env:PATH = "C:\dotnet;$env:PATH"

mkdir -p /opt/dotnet
tar -xzf aspnetcore-runtime-9.0.x-linux-x64.tar.gz -C /opt/dotnet
export DOTNET_ROOT="/opt/dotnet"
export PATH="/opt/dotnet:$PATH"

Instalar construtor de APIs de Dados

O diretório dab-tool da máquina de staging já é autossuficiente. Adicione-o ao seu PATH:

$env:PATH = "C:\path\to\dab-tool;$env:PATH"
dab --version

export PATH="/path/to/dab-tool:$PATH"
dab --version

Passo 4: Configurar e executar

1. Crie o seu ficheiro de configuração:

   dab init --database-type mssql --connection-string "Server=<server>;Database=<database>;User ID=<user>;Password=<password>;TrustServerCertificate=true"
   

2. Adicionar entidades:

   dab add <entity-name> --source <schema>.<table> --permissions "anonymous:*"
   

3. Inicie DAB:

   dab start
   

Validar a instalação

Verifique se o DAB está a correr verificando o endpoint da API REST:

curl http://localhost:5000/api/<entity-name>

Para validação do servidor MCP, verifique se o endpoint de saúde responde:

curl http://localhost:5000/health

Considerações de rede e firewall

• O DAB ouve na porta 5000 por defeito. Ajuste com ASPNETCORE_URLS, se necessário.
• Se estiver a usar CORS, configure as origens permitidas no ficheiro dab-config.json.
• Não é necessário acesso à internet de saída em tempo de execução. O DAB opera inteiramente contra bases de dados locais ou acessíveis em rede.

Conteúdo relacionado

• Executar num container Docker
• Instalar a CLI
• Resolução das portas