CLI resolução de problemas

Comece com um pequeno conjunto de verificações locais e de autenticação:

champrep version
champrep config path
champrep config env
champrep auth whoami
champrep auth status

Não cole APIchaves, tokens do navegador, segredos de webhook ou saídas de depuração não editadas em uma solicitação de suporte.

Comando não encontrado

Confirme se o arquivo binário existe e está em PATH:

command -v champrep
echo "$PATH"

O instalador direto normalmente utiliza $HOME/.local/bin para um usuário que não seja root. Adicione esse diretório ao arquivo de inicialização do shell e abra um novo terminal. Se houver várias cópias instaladas, remova a mais antiga ou coloque o diretório pretendido em primeiro lugar no PATH.

Utilize a aprovação sem interface gráfica:

champrep auth login --no-browser

Abra a URL exibida em um navegador confiável. Se a aprovação expirar, inicie um novo login em vez de reutilizar a URL antiga.

Autenticação necessária ou inválida

champrep auth list
champrep auth whoami

Verifique se CHAMPREP_TOKEN está definido. Ele substitui o keychain do processo atual e pode fazer com que o CLIutilize uma credencial diferente da esperada.

test -n "$CHAMPREP_TOKEN" && echo "ephemeral token override is active"

Não imprima o valor. Renove o login do navegador ou substitua uma chave de automação revogada conforme apropriado.

Conta, perfil ou ambiente incorreto

champrep auth list
champrep auth switch PROFILE
champrep config env
champrep --env production auth whoami

A troca de perfil ocorre dentro de uma conta já autenticada na máquina. Autentique-se separadamente para adicionar uma conta diferente.

Escopo insuficiente ou acesso negado

A credencial pode ser válida, embora a solicitação seja negada devido ao seu escopo, plano ativo, disponibilidade do serviço, política da organização, função ou permissão de recurso.

Executar champrep auth status.
Identifique o escopo de serviço exigido pelo comando.
Analise a chave no painel de ChavesAPI.
Confirme se o perfil ativo pode realizar a mesma ação na interface do usuário do serviço.
Crie ou alterne para uma chave de privilégios mínimos com o escopo ausente quando a carga de trabalho estiver autorizada a possuí-la.

Limitação de taxa

Código de saída 5 significa que um limite atual do Gateway foi atingido. Aguarde o período de repetição indicado, reduza o trabalho paralelo e evite consultas frequentes. Os limites são determinados pela configuração atual da conta; não faça com que um script presuma um número fixo para um nome de plano.

Falha de rede ou de serviço

Utilize primeiro a saída detalhada apenas com metadados:

champrep --verbose auth whoami

--debug pode incluir corpos de solicitação ou resposta. Utilize-o apenas em um terminal controlado e revise a saída antes de compartilhá-la.

Verifique as configurações de DNS, proxy, firewall e inspeção TLS. O CLIdeve acessar o CHAMPREP API Gatewaypor meio de HTTPS. CHAMPREP_API_URL, quando utilizado para desenvolvimento, deve identificar um endpoint compatível com o Gateway e não um serviço individualAPI.

Para 502, 503, ou 504, tente novamente uma leitura segura com recuo limitado. Não repita uma operação de criação, atualização, envio ou exclusão até saber se a primeira solicitação surtiu efeito.

Colete um relatório de suporte seguro

Inclua:

champrep version saída;
sistema operacional e arquitetura;
o nome do comando com argumentos confidenciais removidos;
o nome do ambiente selecionado;
o código de saída;
o status HTTP e o código de erro estável;
a hora aproximada e o fuso horário da falha.

Exclua credenciais e conteúdo confidencial. Em seguida, entre em contato com CHAMPREP Suporte.