⚠️ Processo de instalação - basedosdados/pipelines GitHub Wiki

[!CAUTION] Esse documento está desatualizado, siga o CONTRIBUTING.md

Instalar o WSL 2 - Ubuntu

  • Se você usa o windows é essencial Instalar o WSL 2 - Ubuntu
  • Siga esse passo a passo

Instalar o pyenv

É importante instalar o pyenv para garantir que a versão de python é padrão. Escrevemos uma versão resumida mas recomendamos esse material e esse para mais informações.

  • Comando para instalar dependencias: sudo apt-get install -y make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev python-openssl
  • Comando para instalar o pyenv: curl https://pyenv.run | bash
    • ATENÇÃO: leia atentamente os avisos depois desse comando, existe um passo a passo essencial para que o pyenv funcione
  • Comando para ver lista de versões do pyenv: pyenv install --list
  • Comando para instalar a versão padrão de desenvolvimento: pyenv install -v 3.9.17
  • Comando para definir essa versão como versão global: pyenv global 3.9.17

Criar o ambiente virtual dentro do repositório

  • Comando para criar o ambiente: python -m venv .venv
  • Comando para ativar o ambiente: source .venv/bin/activate

Atualizar o pip

É muito importante garantir que a versão está atualizada na venv antes de instalar o poetry

  • Comando para atualizar o pip: python -m pip install --upgrade pip

Instalando os pacotes necessários

  • Com o pip atualizado, instalar o poetry: pip install poetry
  • Na pasta de pipelines rodar o comando poetry install
  • Caso a instalação do Poetry de erro no pacote do R, recomendado rodar a seguinte linha para instalar o R-base sudo apt -y install r-base

Instalando as dependências

  • pip3 install -r requirements-cli.txt
  • Caso dê problema na instalação das dependências, rode os seguintes comandos: pip install --upgrade basedosdados pipelines loguru e pip install basedosdados==2.0.0b5 pipelines==0.1.0 loguru==0.7.0

Erros comuns

Arquivo .env

  • Se atente para sempre carregar o arquivo com o comando source .env
  • Há a extensão do vscode chamada Python Environment Manager que você consegue ver e configurar as envs. Segue o link: Python Environment Manager
  • Garanta que o arquivo .env está certinho:
    • Não deve ter espaços após o :
    • Não pode ter _a mais nem a menos

Arquivo auth.toml

  • Não se esqueça de criar o arquivo auth.toml na pasta $HOME/.prefect conforme descrito no README.md
  • Caso você não tenha a api_key do arquivo auth.toml, mande mensagem para a Laura, uma vez que é uma chave pessoal.