MWM Datallog

Português

English

Português

English

Appearance

Introdução ao Datallog ​

Bem-vindo(a) ao Datallog! Este guia o(a) levará do zero até ter uma automação em execução em apenas alguns minutos. O Datallog permite que você escreva funções simples em Python, chamadas tasks, e as execute como uma automação distribuída na nuvem. Ele lida com toda a infraestrutura complexa, para que você possa focar no seu código.

Pré-requisitos ​

TIP

Antes de instalar, é uma boa prática atualizar os pacotes do seu sistema para garantir que você tenha as últimas correções de segurança e dependências.

Linux ​

Você pode atualizar os pacotes do seu sistema usando os seguintes comandos, dependendo da sua distribuição:

Ubuntu/Debian ​
bash
sudo apt-get update && sudo apt-get upgrade -y
Fedora/RHEL/CentOS ​
bash
sudo dnf update -y
Arch Linux ​
bash
sudo pacman -Syu

macOS ​

No macOS, você pode atualizar o Homebrew e os pacotes instalados com:

bash
brew update && brew upgrade

Windows (via WSL) ​

O Datallog é executado em um ambiente Linux. No Windows, você pode conseguir isso usando o Subsistema do Windows para Linux (WSL).

  1. Instale o WSL: Siga o guia oficial da Microsoft para instalar o WSL. Recomendamos instalar a distribuição Ubuntu.

Assim que o WSL e o Docker estiverem configurados, abra o seu terminal WSL (por exemplo, Ubuntu) e siga as instruções de instalação do Linux abaixo.

macOS ​

Certifique-se de ter o gerenciador de pacotes Homebrew instalado. O script de instalação o usará para gerenciar as dependências.

Linux ​

Certifique-se de ter o comando curl ou wget disponível. Você pode instalá-los usando o gerenciador de pacotes do seu sistema (por exemplo, sudo apt install curl wget).

Instalação ​

A instalação do SDK do Datallog é uma linha de comando simples. O script instalará automaticamente todas as dependências necessárias, incluindo pyenv, Docker e o CLI do Datallog.

Abra o seu terminal (ou seu terminal WSL no Windows) e execute um dos seguintes comandos:

bash
curl -SsLf https://mwm.datallog.com/install.sh | bash

Ou, se preferir wget:

bash
wget -qO- https://mwm.datallog.com/install.sh | bash

Após a conclusão da instalação, reinicie o seu terminal para que as alterações no PATH (caminho) entrem em vigor.

Verifique a instalação conferindo a versão:

bash
datallog --version

Criando Sua Primeira Automação ​

Vamos construir uma automação simples "Hello, World!" (Olá, Mundo!). 🚀

1. Inicialize um Projeto ​

Primeiro, crie um novo diretório para o seu projeto, navegue até ele e inicialize um projeto Datallog.

bash
datallog create-project my-first-datallog-project
cd my-first-datallog-project

Este comando cria um arquivo project.ini, que gerencia a configuração e as aplicações do seu projeto.

2. Crie uma Automação ​

Agora, vamos criar uma nova automação dentro do projeto. Vamos chamá-la de hello-auto.

bash
datallog create-automation hello-auto

Isso criará um novo diretório chamado hello-auto com um arquivo Python padrão dentro.

3. Escreva o Código ​

Abra o arquivo automations/hello-auto/hello-auto.py e substitua seu conteúdo pelo seguinte código:

python
from datallog import core_task, task

# O primeiro task da nossa automação.
# O argumento `next_task` informa ao Datallog para onde enviar a saída.
@core_task(next_task="second_task")
def first_task(seed):
  """
  Esta função é o ponto de entrada e retorna uma string simples.
  O argumento 'seed' são os dados iniciais passados quando a automação é executada.
  """
  return seed["message"] if seed else "Hello, World!"

# O segundo e último task.
@task()
def second_task(text_input):
  """
  Esta função recebe a saída de 'first_task'
  e retorna uma versão em letras maiúsculas da mesma.
  """
  return text_input.upper()

4. Execute a Automação ​

TIP

Você pode fornecer dados seed iniciais para a sua automação de duas maneiras:

  • Use --seed para valores JSON pequenos e diretos da linha de comando (ex.: datallog run hello-auto --seed '{"message": "Olá!"}').
  • Use --seed-file para dados JSON maiores ou mais complexos armazenados em um arquivo (ex.: datallog run hello-auto --seed-file seed.json).
    Se você não especificar nenhuma das opções, mas um arquivo seed.json existir no diretório da sua automação, ele será usado automaticamente.
    Nota: --seed e --seed-file não podem ser usados juntos. :::

Você pode executar sua automação localmente para testá-la. Use o comando run seguido pelo nome da automação.

bash
datallog run hello-auto

Você deverá ver uma saída indicando que as tasks estão sendo executadas, com o resultado final sendo impresso no console.