> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# base44 functions deploy

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

<Warning>
  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](/developers).
</Warning>

# base44 functions deploy

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

## Sintaxe

```bash theme={null}
npx base44 functions deploy [names...] [options]
```

## Opções

| Opção        | Descrição                                                                                   | Obrigatório |
| ------------ | ------------------------------------------------------------------------------------------- | ----------- |
| `[names...]` | Um ou mais nomes de função para implantar (implanta todas se omitido)                       | Não         |
| `--force`    | Exclui 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

```bash theme={null}
# 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

```bash theme={null}
$ 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`:

```bash theme={null}
$ 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:

```bash theme={null}
$ npx base44 functions deploy
No functions found. Create functions in the 'functions' directory.
```

Se `--force` for combinado com nomes de função:

```bash theme={null}
$ 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:

```bash theme={null}
$ 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](https://docs.base44.com/developers/skills/base44-cli/references/functions-create.md)

<Note>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>