Instalação local

Requisitos

Existem três formas de rodar essa aplicação localmente:

• ou com a imagem Docker
• ou gerando o binário a partir do código fonte
• ou com Docker Compose — apenas para desenvolvimento (não é recomendado para o banco de dados completo por problemas de lentidão)

As duas últimas alternativas necessitam do código fonte. Você pode usar o Git para baixar o código do projeto:

$ git clone https://github.com/cuducos/minha-receita.git

Talvez seja necessário um sistema UNIX (Linux ou macOS), mas não tenho certeza pois não testei em Windows.

É necessário cerca de 150Gb disponíveis de espaço em disco para armazenar os dados:

• Os arquivos da Receita federal tem cerca de 6Gb
• O banco de dados PostgreSQL gerado utiliza cerca de 140Gb

Requisitos e instalação

Imagem Docker

• Docker

Baixar a imagem com:

$ docker pull ghcr.io/cuducos/minha-receita:main

A partir do código fonte

• Go versão 1.22

Depois de clonar o repositório, baixe as dependências e compile a aplicação para um diretório incluído no PATH, por exemplo:

$ go get
$ go build -o /usr/local/bin/minha-receita main.go

Docker Compose

• Docker
• Docker Compose
• Arquivo .env (copie o .env.sample e ajuste caso necessário)

Gere as imagens dos containers com:

$ docker compose build

Execução e configurações

Várias configurações podem ser passadas para a CLI, e elas estão documentadas no --help de cada comando da aplicação.

Exemplos

Imagem Docker

$ docker run --rm ghcr.io/cuducos/minha-receita:main --help --help
$ docker run --rm ghcr.io/cuducos/minha-receita:main --help api --help

A partir do código fonte

$ minha-receita --help
$ minha-receita api --help

Docker Compose

$ docker compose run --rm minha-receita --help
$ docker compose run --rm minha-receita api --help

Variáveis de ambiente

Para facilitar a manutenção, algumas variáveis de ambiente podem ser utilizadas, mas todas são opcionais: