certdoctorDokumentacja
Wszystko, co robią wiersz poleceń i okno, i jak czytać to, co mówią.
certdoctor to dwa programy nad jedną diagnozą. certdoctor to wiersz poleceń: podajesz mu adres, który nie działa, a on wypisuje raport w terminalu albo zapisuje go do zgłoszenia lub dla pipeline’u. certdoctor-gui to okno, które uruchamia ten sam wiersz poleceń i pokazuje ten sam raport, dla każdego, kto woli wpisać adres w pole.
Przebieg idzie drogą, którą idzie połączenie - środowisko, rozwiązywanie nazw, proxy, TCP, TLS - a potem pyta każdy magazyn zaufania, jaki znajdzie na maszynie, czy ufa łańcuchowi, który pokazał serwer. Raport zaczyna się od jednego zdania, które nazywa przyczynę, a każdy magazyn z odmową niesie polecenie, które by go naprawiło.
Jeśli przychodzisz z komunikatem błędu, strony błędów zaczynają od komunikatu. Jeśli wiesz, który program odmawia, poradniki zaczynają od programu.
Pierwsze kroki
Pobierz certdoctor, uruchom go na adresie, który nie działa, i przeczytaj zdanie, które nazywa przyczynę. Potem wypróbuj go na celowo zepsutej stronie.
Czytanie raportu
Co znaczy każda część raportu certdoctor: zdanie z werdyktem, kod wyjścia, sześć warstw, wiersze macierzy zaufania i polecenia, które niosą.
Sześć warstw
Sześć warstw przebiegu certdoctor: zmienne środowiskowe, DNS z każdego serwera, proxy i PAC, TCP do każdego adresu, łańcuch TLS i macierz zaufania.
Macierz zaufania
certdoctor pyta każdy magazyn zaufania na maszynie - Windows, pakiet Linuksa, każdy JDK, git, curl, node, Python i pip - i wypisuje naprawę dla każdego.
Proxy i skrypt PAC
Jak certdoctor ustala, przez które proxy naprawdę idzie adres: zmienne środowiskowe, ustawienia internetowe i WinHTTP w Windows, skrypt PAC i odpowiedź 407.
Raporty i formaty
Zapisz raport certdoctor jako Markdown do zgłoszenia, samodzielną stronę HTML albo JSON, zamaskuj nazwy hostów przez --redact i zrób stronę z JSON-a.
Użycie w CI
Sprawdź, czy agent budujący dosięga rejestru albo API: kody wyjścia certdoctor, JSON sprawdzony ze schematem i raport zachowany jako artefakt.
W kontenerze
Skopiuj statyczną binarkę na Linuksa do kontenera i uruchom ją tam: raport opisuje wtedy DNS, proxy i magazyny zaufania kontenera, a nie hosta.
Okno
certdoctor-gui pokazuje ten sam raport w oknie na Windowsie, Linuksie i macOS: wpisz adres, naciśnij Diagnose, przeczytaj raport i zapisz go.
Wiersz poleceń
Każda flaga wiersza poleceń certdoctor: adres, --pac-url, --from, --format, --json, --out, --redact, --quiet, --verbose, limity czasu i pozostałe.
Kody wyjścia
Kody wyjścia certdoctor: 0 w porządku, 4 znaleziono usterkę, 5 czegoś nie dało się ocenić, oraz kody dla składni, konfiguracji, zapisu i przerwania.
Sprawdź pobrany plik
Sprawdź archiwum certdoctor z listą SHA-256 wydania i udowodnij, skąd pochodzi, podpisanym przez GitHuba zestawieniem składników.