Skip to main content

Preparar a máquina local

View as MarkdownThe same page as plain textOpen in ChatGPTAsk about this pageOpen in ClaudeAsk about this page

Os quatro passos entre uma máquina nova e o primeiro comando que fala com dev, sem privilégio de administrador.

O objetivo é chegar até panlabs ambiente atual respondendo dev. Nada aqui exige privilégio de administrador, e nada instala pacote do sistema: o ambiente inteiro mora no diretório do projeto, que é o que torna o procedimento repetível e descartável.

Antes de começar​

Python 3.12 ou mais novo, git, e acesso ao índice interno de pacotes. O acesso ao índice vem do mesmo login corporativo; se pip pedir usuário e senha, o login não está propagado ainda.

Os passos​

  1. Criar o ambiente virtual

    Dentro do diretório do projeto, sempre com o nome .venv: a esteira e os editores procuram por esse nome.

    python3.12 -m venv .venv
    source .venv/bin/activate

  2. Instalar as ferramentas da casa

    Um pacote só, que traz o CLI e as dependências de desenvolvimento.

    pip install --index-url "$PANLABS_INDICE" "panlabs-cli>=3.2"

  3. Apontar para o ambiente

    O comando escreve o perfil da AWS e o papel a assumir. Ele não guarda credencial: guarda a instrução de como obtê-la.

    panlabs ambiente usar dev

  4. Conferir

    A saída deve nomear o ambiente e o papel, nesta ordem.

    panlabs ambiente atual
    # dev · papel-<equipe>-dev · us-east-1 · sessão válida por 11h58

Verificação​

Se panlabs ambiente atual responde dev e a sessão tem validade, a máquina está pronta. O primeiro comando que de fato fala com a nuvem é o de listagem, e ele é o teste real:

panlabs catalogo listar --limite 1

panlabs ambiente atual não faz chamada de rede: ele lê a configuração local. É por isso que ele responde rápido e é por isso que ele não prova acesso; quem prova é o comando de listagem.

Variações​

Sem acesso ao índice interno. Use o espelho público e instale só o CLI, sem as dependências internas: pip install panlabs-cli --no-deps. Vários subcomandos vão faltar, e o de ambiente funciona.

Mais de um projeto na mesma máquina. Cada projeto tem o próprio .venv e a própria configuração de ambiente. O panlabs ambiente usar escreve no diretório do projeto, nunca no diretório do usuário: trocar de projeto troca de ambiente sozinho.

Não copie o .venv entre máquinas nem o comite. Ele carrega caminhos absolutos, e um .venv copiado falha com erro de interpretador que não aponta para a causa.