Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ambarks.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Criando um ambarks.json

O arquivo ambarks.json permite dizer ao AmbarksCloud como preparar e iniciar seu projeto quando o comportamento automatico nao e suficiente. Crie o arquivo na raiz do projeto: 
meu-projeto/
  ambarks.json
  package.json
  src/
Tambem e aceito o nome ambarks.config.json.

​
Exemplo completo

{
  "build": {
    "installCommand": "npm ci",
    "buildCommand": "npm run build"
  },
  "run": {
    "command": "npx tsx src/index.ts"
  }
}

​
Campos aceitos

CampoUso
build.installCommandComando para instalar dependencias
build.installAtalho alternativo para comando de instalacao
build.buildCommandComando para gerar build
build.commandAtalho alternativo para comando de build
run.commandComando usado para iniciar a aplicacao

​
Exemplos por runtime

​
Node.js

{
  "build": {
    "installCommand": "npm ci",
    "buildCommand": "npm run build"
  },
  "run": {
    "command": "npm run start"
  }
}

​
Python com FastAPI

{
  "build": {
    "installCommand": "pip install --no-cache-dir -r requirements.txt"
  },
  "run": {
    "command": "uvicorn main:app --host 0.0.0.0 --port 8000"
  }
}

​
Site estatico com build

{
  "build": {
    "installCommand": "npm ci",
    "buildCommand": "npm run build"
  },
  "run": {
    "command": "npm run preview -- --host 0.0.0.0"
  }
}

​
Regras importantes

  • O JSON precisa ser valido.
  • O arquivo deve estar na raiz do projeto enviado.
  • O comando de start deve manter o processo rodando.
  • Servidores web devem escutar em 0.0.0.0.
  • A porta usada pelo comando deve bater com a porta interna configurada no projeto.

​
Quando nao usar

Se seu projeto precisa instalar pacotes do sistema, copiar arquivos para pastas especificas ou usar varias etapas de build, prefira Dockerfile.