Skip to main content
Esta página faz parte de uma habilidade de agente de código IA e é escrita para agentes, não para humanos. Para a documentação legível por humanos da Base44, veja a documentação para desenvolvedores.

​
base44 functions deploy

Implanta definições de função locais na Base44.

​
Sintaxe

npx base44 functions deploy [names...] [options]

​
Opções

OpçãoDescriçãoObrigatório
[names...]Um ou mais nomes de função para implantar (implanta todas se omitido)Não
--forceExclui funções remotas não encontradas localmente (não pode ser combinado com [names...])Não

​
Autenticação

Obrigatório: Sim. Se não estiver autenticado, você será solicitado a fazer login primeiro.

​
O que faz

  1. Escaneia o diretório base44/functions/ em busca de definições de função
  2. Descobre funções a partir de arquivos entry.ts/entry.js
  3. Exibe a contagem de funções a serem implantadas
  4. Faz upload do código da função para a Base44 sequencialmente
  5. Reporta os resultados: contagens de implantadas, inalteradas e falhadas
  6. Se --force for usado: também exclui funções remotas que não existem mais localmente

​
Pré-requisitos

  • Deve ser executado a partir de um diretório de projeto Base44
  • O projeto deve ter definições de função na pasta base44/functions/
  • Cada função deve ser uma pasta com entry.ts ou entry.js

​
Exemplos

# Implanta todas as funções
npx base44 functions deploy

# Implanta funções específicas
npx base44 functions deploy process-order send-notification

# Implanta todas e exclui funções removidas localmente
npx base44 functions deploy --force

​
Saída

$ npx base44 functions deploy

◆ Found 2 functions to deploy
◇ [1/2] Deploying process-order...
✓ process-order               deployed
◇ [2/2] Deploying send-notification...
✓ send-notification           deployed

└ 2 deployed
Com --force: 
$ npx base44 functions deploy --force

◆ Found 2 functions to deploy
...

◆ Found 1 remote function to delete
◇ [1/1] Deleting old-function...
✓ old-function                deleted

◆ 1 deleted

└ 2 deployed

​
Códigos de saída

  • Código de saída 0: Todas as funções implantadas com sucesso (ou inalteradas)
  • Código de saída 1: Uma ou mais funções falharam ao implantar
Quando qualquer função falha, o comando imprime o resumo completo da implantação e sai com código 1. Isso torna seguro usá-lo em pipelines de CI onde uma falha parcial deve bloquear o build.

​
Tratamento de erros

Se nenhuma função for encontrada no seu projeto: 
$ npx base44 functions deploy
No functions found. Create functions in the 'functions' directory.
Se --force for combinado com nomes de função: 
$ npx base44 functions deploy my-func --force
error: --force cannot be used when specifying function names
Se um nome de função especificado não existir localmente: 
$ npx base44 functions deploy nonexistent
error: Function not found in project: nonexistent

​
Casos de uso

  • Após criar novas funções no seu projeto
  • Ao modificar código de função existente
  • Para sincronizar alterações de função antes de testar
  • Como parte do seu fluxo de desenvolvimento quando a lógica de backend muda
  • Use --force para limpar funções remotas que foram removidas localmente

​
Notas

  • Este comando implanta o código da função
  • As alterações são aplicadas ao seu projeto Base44 imediatamente
  • Resultados de implantação por função: deployed, unchanged ou error
  • --force não pode ser combinado com nomes de função específicos
  • Certifique-se de testar as funções em um ambiente de desenvolvimento primeiro
  • As definições de função estão localizadas no diretório base44/functions/
  • Use entry.ts ou entry.js para funções
  • Para saber como criar funções, veja functions-create.md
Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.