Konfigurasjon
CLI-en leser hver innstilling fra flagg, miljøvariabler, konfigurasjonsfilen sin og innebygde standardverdier, og lagrer alt under ~/.polylane. Denne siden lister rekkefølgen, variablene og hvordan du styrer telemetri.
Prioritet
CLI-en løser hver innstilling i denne rekkefølgen, høyeste vinner:
- CLI-flagg, for eksempel
--workspace,--api-key,--outputog--timeout. - Miljøvariabler:
POLYLANE_*-settet pluss standardvariableneNO_COLORogDO_NOT_TRACK. - Bare for legitimasjonen: OAuth-tokener i
~/.polylane/credentials.json. - Konfigurasjonsfilen i
~/.polylane/config.json. - Innebygde standardverdier: domene
api.polylane.com, tidsavbrudd 300 sekunder, utdatatexti en terminal ogjsonnår den pipes.
En eksportert POLYLANE_API_KEY slår alltid en utdatert ~/.polylane/credentials.json, så en CI-runner med variabelen satt plukker ikke opp gjenglemte OAuth-tokener. Autentisering lister den samme rekkefølgen for legitimasjon.
Konfigurasjonsfil
~/.polylane/config.json aksepterer seks nøkler: domain, workspace_id, api_key, output, timeout og telemetry. Administrer den gjennom CLI-en: config show skriver ut den løste konfigurasjonen, autentiseringsmetoden i bruk og filstien, med API-nøkler maskert.
polylane config show
polylane config set --key output --value json
For å sette standard-workspacet etter slug i stedet for ID kjører du polylane workspace use <slug>. OAuth-legitimasjon ligger separat i ~/.polylane/credentials.json og fornyes av seg selv når tilgangstokenet nærmer seg utløp.
Miljøvariabler
| Variabel | Beskrivelse |
|---|---|
POLYLANE_API_KEY | Autentiser uten å lagre en nøkkel på disk |
POLYLANE_WORKSPACE_ID | Sett workspacet for det gjeldende shellet |
POLYLANE_API_DOMAIN | Pek på et annet API-vertsnavn; bare vertsnavn, ingen protokoll |
POLYLANE_OUTPUT | Tving frem text- eller json-utdata |
POLYLANE_TIMEOUT | Tidsavbrudd for forespørsler i sekunder |
POLYLANE_VERBOSE | Aktiver detaljert logging |
POLYLANE_TELEMETRY=0 | Deaktiver telemetri for dette miljøet |
DO_NOT_TRACK=1 | Det universelle telemetrifravalget; overstyrer hver annen telemetriinnstilling, inkludert konfigurasjonsfilen |
NO_COLOR | Deaktiver ANSI-farger |
Telemetri
Anonym brukstelemetri er på som standard. Den registrerer kommandonavnet, flaggnavn, antall posisjonsargumenter, avslutningskoden og feilkategorien, varigheter, CLI- og Node-versjoner, detaljer om operativsystemet, en anonym identifikator per installasjon og workspace-ID-en. Flaggverdier, argumenter, filstier, kommandoutdata og fullstendige feilmeldinger holdes utenfor, og polylane telemetry status viser nøyaktig hva som sendes, og hvor.
Slå den av for godt med polylane telemetry disable, som skriver til konfigurasjonsfilen, eller per miljø med POLYLANE_TELEMETRY=0 eller DO_NOT_TRACK=1. Beslutningen følger DO_NOT_TRACK, så POLYLANE_TELEMETRY, så konfigurasjonsfilen, så standardvalget på; det finnes ikke noe flagg per kjøring.
Filer på disk
Alt CLI-en lagrer, ligger under ~/.polylane:
| Fil | Beskrivelse |
|---|---|
config.json | Lagrede innstillinger: domene, workspace, API-nøkkel, utdata, tidsavbrudd, telemetri |
credentials.json | OAuth-tokener |
telemetry.json | Anonym installasjons-ID og kjøretellere |
update-state.json | Tilstand for oppdateringssjekk |
Slett katalogen for å tilbakestille CLI-en fullstendig; en ny installasjons-ID genereres ved neste kjøring.
Relatert
- Autentisering: innloggingsmetodene og hvordan legitimasjon velges.
- Skripting: utdatakontrakten, skriptflagg og avslutningskoder.