CLI Solución de problemas

Comience con una serie reducida de comprobaciones locales y de autenticación:

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

No pegue APIclaves, tokens del navegador, secretos de webhooks ni resultados de depuración sin censurar en una solicitud de asistencia.

Comando no encontrado

Compruebe que el archivo binario existe y se encuentra en PATH:

command -v champrep
echo "$PATH"

El instalador directo suele utilizar $HOME/.local/bin para un usuario que no sea root. Añada ese directorio al archivo de inicio del shell y abra un nuevo terminal. Si hay varias copias instaladas, elimine la más antigua o coloque el directorio deseado en primer lugar en PATH.

No se abre la página de inicio de sesión del navegador

Utilice la aprobación sin interfaz gráfica:

champrep auth login --no-browser

Abra la URL mostrada en un navegador de confianza. Si caduca la autorización, inicie un nuevo inicio de sesión en lugar de reutilizar la URL anterior.

Se requiere autenticación o la autenticación no es válida

champrep auth list
champrep auth whoami

Compruebe si CHAMPREP_TOKEN está configurada. Anula el llavero del proceso actual y puede hacer que el CLIutilice una credencial diferente a la esperada.

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

No muestre el valor. Actualice los datos de inicio de sesión del navegador o sustituya una clave de automatización revocada según corresponda.

Cuenta, perfil o entorno incorrectos

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

El cambio de perfil se realiza dentro de una cuenta ya autenticada en el equipo. Autentíquese por separado para añadir una cuenta diferente.

Ámbito insuficiente o acceso denegado

La credencial puede ser válida aunque la solicitud sea denegada por su ámbito, plan activo, disponibilidad del servicio, política de la organización, rol o permiso de recurso.

Ejecutar champrep auth status.
Identifique el ámbito de servicio requerido por el comando.
Revise la clave en el panel de control «ClavesAPI».
Confirme que el perfil activo puede realizar la misma acción en la interfaz de usuario del servicio.
Cree o rote a una clave de privilegios mínimos con el ámbito que falte cuando la carga de trabajo esté autorizada a disponer de ella.

Límite de frecuencia

Código de salida 5 significa que se ha alcanzado un límite actual de Gateway. Espere el periodo de reintento indicado, reduzca el trabajo en paralelo y evite las consultas frecuentes. Los límites vienen determinados por la configuración actual de la cuenta; no haga que un script asuma un número fijo para un nombre de plan.

Fallo de red o del servicio

Utilice primero la salida detallada solo con metadatos:

champrep --verbose auth whoami

--debug puede incluir cuerpos de solicitud o de respuesta. Utilícelo únicamente en un terminal controlado y revise la salida antes de compartirla.

Compruebe la configuración de DNS, proxy, cortafuegos e inspección TLS. El CLIdebe poder acceder a CHAMPREP a API Gatewaytravés de HTTPS. CHAMPREP_API_URL, cuando se utilice para el desarrollo, debe identificar un punto final compatible con Gateway y no un servicio individualAPI.

Para 502, 503, o 504, vuelva a intentar una lectura segura con un tiempo de espera limitado. No repita una operación de creación, actualización, envío o eliminación hasta que sepa si la primera solicitud ha surtido efecto.

Recopile un informe de soporte seguro

Incluya:

champrep version salida;
sistema operativo y arquitectura;
el nombre del comando sin los argumentos confidenciales;
el nombre del entorno seleccionado;
el código de salida;
el estado HTTP y el código de error estable;
la hora aproximada y la zona horaria en la que se produjo el fallo.

Excluya las credenciales y el contenido confidencial. A continuación, póngase en contacto con CHAMPREP Soporte técnico.