@aether-baas/cli

CLI oficial para gerenciar projetos Aether - Enterprise Ready com CI/CD

🚀 Instalação

# Instalação global
npm install -g @aether-baas/cli

# Ou via npx (sem instalação)
npx @aether-baas/cli <comando>

📋 Comandos

Autenticação

# Login interativo
aether login

# Ver status da sessão
aether whoami

# Logout
aether logout

Projetos

# Vincular pasta a um projeto
aether link

# Ver configuração atual
aether config --show

# Configurar API URL (opcional)
aether config --api-url https://api.aether.app

Functions

# Fazer deploy de todas as functions
aether deploy

# Deploy em paralelo (mais rápido)
aether deploy --parallel

# Listar functions do projeto
aether list

# Ver logs
aether logs

# Executar function manualmente
aether invoke <nome-da-function>

# Deletar function
aether delete <nome-da-function>

🔐 CI/CD (GitHub Actions, GitLab, etc.)

O CLI suporta autenticação via Service API Key para pipelines automatizados:

# .github/workflows/deploy.yml
name: Deploy Aether Functions

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      
      - name: Deploy to Aether
        env:
          AETHER_SERVICE_KEY: ${{ secrets.AETHER_SERVICE_KEY }}
          AETHER_PROJECT_ID: ${{ secrets.AETHER_PROJECT_ID }}
        run: npx @aether-baas/cli deploy

Variáveis de Ambiente

| Variável | Descrição | |----------|-----------| | AETHER_SERVICE_KEY | API Key do projeto (substitui login) | | AETHER_PROJECT_ID | ID do projeto (substitui aether.json) | | AETHER_API_URL | URL da API (opcional) |

📁 Estrutura do Projeto

my-project/
├── aether.json          # Configuração do projeto
├── functions/           # Pasta das functions
│   ├── onNewUser.ts
│   ├── sendEmail.ts
│   └── processPayment.ts
└── ...

aether.json

{
    "projectId": "seu-project-id",
    "functions": "functions"
}

🔧 Configuração

Prioridade de Autenticação

1. AETHER_SERVICE_KEY (env var) - CI/CD
2. AETHER_ACCESS_TOKEN (env var)
3. Token salvo via aether login

Prioridade de Project ID

1. AETHER_PROJECT_ID (env var) - CI/CD
2. aether.json na pasta atual
3. Projeto linkado via aether link
4. Config global do CLI

📝 Exemplo de Function

// functions/onNewUser.ts
export default async function(context: AetherContext) {
    const { data, db, push } = context;
    
    // Salvar no banco
    await db.collection('welcome_emails').create({
        userId: data.userId,
        sentAt: new Date()
    });
    
    // Enviar push notification
    await push.send({
        to: data.userId,
        title: 'Bem-vindo!',
        body: 'Obrigado por se cadastrar'
    });
    
    return { success: true };
}

🆘 Suporte

• Documentação
• Discord
• Issues

📄 Licença

ISC © Aether BaaS