Usar o emulador do Data Connect para CI/CD

Observação: o Firebase Data Connect está no Acesso antecipado. O Data Connect está sujeito aos "Termos das ofertas pré-GA" na seção Termos específicos de serviço dos Termos de Serviço do Google Cloud Platform. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

O Firebase Data Connect fornece um emulador local para prototipagem de ponta a ponta, além de fluxos de integração e implantação contínuas (CI/CD):

• O emulador Data Connect interage com uma instância de banco de dados PGLite integrada local para permitir que você crie protótipos de consultas e mutações e teste o código do cliente em um ambiente totalmente local.
• O emulador Data Connect também pode ser usado para trabalhos não interativos. Ele permite executar testes automatizados e é adequado para uso com fluxos de trabalho de CI/CD. Isso é útil quando seus esquemas são estáveis e você quer criar protótipos e testar o código do lado do cliente.

Este guia aborda a instalação e o uso do emulador com mais detalhes do que o guia de início rápido.

Instalar o emulador Data Connect

Antes de instalar o Local Emulator Suite para usar o emulador Data Connect, você vai precisar do seguinte:

• Node.js versão 18.0 ou mais recente

Instalar a CLI Firebase e configurar o diretório do projeto

Observação: se você seguiu o guia Começar a usar o Firebase Data Connect, pule esta seção.

1. Instale a CLI Firebase, seguindo o guia de instalação. Faça atualizações regularmente, já que o emulador Data Connect está em desenvolvimento ativo com correções de bugs e novos recursos.

2. Se você ainda não tiver feito isso, inicialize o diretório de trabalho atual como um projeto do Firebase, seguindo as instruções para especificar quais produtos usar:

   firebase init

Definir ou modificar a configuração de Local Emulator Suite

Se você tiver iniciado o emulador Data Connect pela extensão do VS Code do Firebase, o emulador será instalado para você, se necessário.

É possível usar a CLI Firebase para instalar manualmente o emulador com outros componentes selecionados do Local Emulator Suite. Esse comando inicia um assistente de configuração que permite selecionar emuladores do seu interesse, fazer o download dos arquivos binários do emulador correspondentes e definir as portas do emulador se os padrões não forem apropriados.

  firebase init emulators

Depois que um emulador for instalado, nenhuma verificação de atualização será realizada e nenhum download automático adicional ocorrerá até que você atualize a versão da CLI Firebase.

Escolher um projeto do Firebase

No fluxo de configuração, a CLI Firebase solicita que você escolha ou crie um projeto do Firebase. Se você escolher um projeto que já tiver configurado com Data Connect no console do Firebase, a configuração escolhida será sugerida.

Configurar o emulador

Observação: o uso do emulador na extensão do VS Code do Firebase Data Connect é abordado em Começar a usar o Firebase Data Connect.

Configurar o emulador

A execução do fluxo firebase init vai orientar você pelas opções de configuração do emulador. Como outros emuladores no Local Emulator Suite, os parâmetros de configuração são armazenados em arquivos de projeto locais.

• O arquivo firebase.json contém atribuições de porta do emulador.
  • A chave emulators:ui não se aplica ao emulador Data Connect.

Trabalhar com recursos Data Connect locais e de produção

Se você quiser ter certeza de que não vai afetar os recursos de produção, defina um projectID demo- ou verifique se o código do cliente está instrumentado para se conectar ao emulador, conforme discutido em uma seção posterior.

Iniciar o emulador

Se você estiver executando o emulador de forma não interativa, por exemplo, para fluxos de trabalho de CI/CD, inicie-o com a opção exec.

firebase emulators:exec ./path/to/test-script.sh

Se você estiver integrando consultas e mutações predefinidas no código do cliente e estiver usando o emulador especificamente para testar clientes, use a opção start para trabalho interativo. Também é possível iniciar o emulador pela extensão do VS Code.

firebase emulators:start

Observação: quando você inicia o emulador com firebase emulators:start, o código do SDK é gerado automaticamente, como se você tivesse executado firebase sdk:generate.

Instrumentalizar o código do cliente para se comunicar com o emulador

Defina a configuração no app ou as classes de teste para interagir com o emulador do Data Connect conforme mostrado a seguir.

JavaScript

import { initializeApp } from "firebase/app";
import { connectorConfig } from "@name-of-package";
import { connectDataConnectEmulator, getDataConnect } from 'firebase/data-connect';

// TODO: Replace the following with your app's Firebase project configuration
const firebaseConfig = {
  //...
};

const app = initializeApp(firebaseConfig);

const dataConnect = getDataConnect(app, connectorConfig);
connectDataConnectEmulator(dataConnect, "localhost", 9399);

// Make calls from your app
  

Kotlin para Android

val connector = MoviesConnector.instance

// Connect to the emulator on "10.0.2.2:9399"
connector.dataConnect.useEmulator()

// (Alternatively) if you're running your emulator on non-default port:
connector.dataConnect.useEmulator(port = 9999)

// Make calls from your app
  

iOS

let connector = DataConnect.dataConnect(DefaultConnectorClient.connectorConfig)

// Connect to the emulator on "127.0.0.1:9399"
connector.useEmulator()

// (alternatively) if you're running your emulator on non-default port:
connector.useEmulator(port: 9999)

// Make calls from your app
  

Usar o emulador para testes e integração contínua

Executar imagens Local Emulator Suite conteinerizadas

A instalação e a configuração do Local Emulator Suite com contêineres em uma configuração de CI típica são simples.

Fique atento a alguns problemas:

• Os binários do emulador são instalados e armazenados em cache em ~/.cache/firebase/emulators/. Adicione esse caminho à configuração do cache de CI para evitar downloads repetidos.
• Se você não tiver um arquivo firebase.json no seu repositório, adicione um argumento de linha de comando ao comando emulators:start ou emulators:exec para especificar quais emuladores devem ser iniciados. Por exemplo, --only dataconnect.

Limpar o banco de dados entre os testes

Para redefinir os ambientes de teste entre execuções, o Firebase recomenda:

• Escrever mutações dedicadas para lidar com o seguinte:
  • Na configuração, preencha uma instância de banco de dados local com dados iniciais.
  • Na desmontagem, exclua os dados modificados da instância do banco de dados pós-teste.

Qual é a diferença entre o emulador do Data Connect e a produção?

O emulador Data Connect simula muitos recursos do produto no lado do servidor. No entanto, há algumas exceções:

• A versão e a configuração detalhada do PGLite podem ser diferentes da versão da sua instância de produção do Cloud SQL.
• Se você estiver usando o emulador para desenvolver com a integração de pgvector e Vertex API do Data Connect, as chamadas para a API Cloud Vertex serão feitas diretamente, em vez de pela integração do Vertex do Cloud SQL. No entanto, as chamadas para a API de produção ainda são feitas, o que significa que você precisa usar um projeto real do Firebase, não pode usar um projeto demo- e os custos da API Vertex serão incorridos.