Penyelenggara yang mengambil alih pada 02:00 tidak dapat menyatakan sama ada perkhidmatan itu sihat, kerana dokumen itu menerangkan reka bentuk dan tidak pernah menyatakan apa yang perlu dijalankan. Menyerahkan fail kepada orang lain dan kemudian meninggalkan bilik ialah satu-satunya ujian yang penting. Kebanyakan nota VPN kecil gagal dalam ujian itu pada halaman kedua. Bentuk di bawah ini lulus ujian itu, dan tiada apa-apa di dalamnya perlu panjang.

Mulakan dengan peta yang boleh diimbas oleh orang yang letih

Tulis apa yang seseorang perlu cari dengan segera: nama yang disambung oleh klien, port yang didengar oleh daemon, kumpulan alamat yang diagihkannya, cara nama klien diselesaikan dan rangkaian mana di belakang terowong yang patut boleh dicapai. Tambah nombor build yang benar-benar anda jalankan, dan namakan komponen yang memiliki setiap bahagian bergerak, kerana laluan, penapis paket dan profil klien sering dikonfigurasikan di tiga tempat berbeza. Catat juga kebergantungan luar: akaun pengehosan, pautan atas, pembekal identiti dan rangkaian peribadi di hujung jauh. Jadual atau rajah yang dilukis dengan tangan membawa perkara ini lebih baik daripada perenggan, kerana pembaca mengimbas dan bukan membaca.

Kemudian namakan orang yang boleh memberi kuasa perubahan kecemasan, dengan laluan hubungan yang tidak bergantung pada terowong berjalan. Laluan pengeskalaan tanpa sandaran ialah jalan buntu tepat dalam insiden yang memerlukannya. Dua nama dan satu nombor telefon sudah cukup; peta itu bukan direktori kakitangan.

Setiap pemeriksaan memerlukan jawapan yang dikira sihat

Bagi setiap perkhidmatan, letakkan arahan dan baris yang bermaksud ia berjaya bersebelahan, supaya pembaca tidak perlu memperoleh satu daripada yang lain dengan segera. Keadaan proses dan kebolehcapaian hujung ke hujung berada pada lapisan berbeza: satu menunjukkan daemon telah menerima konfigurasinya, satu lagi menunjukkan klien boleh menggunakan apa yang ditawarkan terowong. Tulis kedua-dua baris dan nyatakan kegagalan mana yang ditangkap oleh setiap satu, kerana pemeriksaan tanpa hasil yang dinyatakan menjadi perdebatan sama ada output kelihatan baik.

systemctl status openvpn-server@lab
ss -lntu | grep 1194

Jalankan kedua-duanya, dan anggap ia sebagai bukti berasingan dan bukan urutan. Unit hijau boleh berdiri di sebelah terowong yang tiada sesiapa dapat gunakan, dan sebaliknya berlaku apabila pendengar terselamat daripada laluan yang rosak. Nyatakan lapisan yang diperhatikan oleh setiap baris, dan pembaca akan tahu mana untuk dipercayai apabila ia bercanggah.

Tiga kegagalan meliputi kebanyakan malam

Titik akhir tidak dapat dicapai, identiti ditolak dan berhubung tanpa trafik berguna menjelaskan hampir semua yang membangunkan seseorang. Bagi setiap satu, senaraikan dua pemeriksaan pertama dan orang yang perlu dieskalasikan, supaya tiada sesiapa perlu mencipta urutan diagnostik pada 02:00. Tidak dapat dicapai biasanya menunjuk kepada laluan atau pendengar, identiti ditolak kepada sijil, stor kelayakan atau jam, dan sambungan kosong kepada laluan, pemajuan atau penyelesaian nama. Ketiga-tiga cabang itu membaca log berbeza, sebab itu cabang mesti dipilih sebelum log dibuka.

Pautkan dokumentasi hulu dan bukannya menampal arahan yang belum anda jalankan pada hos ini. Arahan yang tidak diuji dan disalin dari persekitaran lain lebih buruk daripada penunjuk, kerana ia kelihatan berwibawa dan gagal secara senyap.

Tulis perubahan sebagai urutan, bukan perenggan

Bagi setiap perubahan, catat titik semak yang boleh anda kembali, pemeriksaan yang mengesahkan kejayaan dan syarat yang mencetuskan pengunduran, dalam urutan itu. Sertakan jalan pulang yang tidak melalui terowong, kerana perubahan yang anda lakukan itulah yang boleh menutupnya. Catat bagaimana pencabutan semasa akan dipulihkan dan bukan petikan segera yang lebih lama, kerana senarai lapuk secara senyap menerima semula kelayakan yang telah dipencenkan pagi itu. Langkah imperatif bernombor bertahan di bawah tekanan; prosa bertukar menjadi tafsiran.

Latih jalan pulang itu sebelum anda memerlukannya, setiap kali perubahan itu cukup besar untuk bermakna. Pengunduran yang ditulis dari ingatan ialah andaian dengan tarikh terlekat.

Kelayakan tinggal di tempat lain

Rujuk pengurus kata laluan, peti besi atau sampul bertutup, dan nyatakan siapa yang boleh membukanya, dan bukannya memetik apa-apa bahan dalam fail. Kunci peribadi, kod pemulihan sekali guna dan profil yang menyematkan rahsia tergolong dalam storan terlindung, dan halaman itu harus menerangkan bagaimana penyelenggara dibenarkan mencapainya pada 02:00. Jangan sekali-kali menggunakan rahsia hidup sebagai contoh, kerana contoh ditampal ke dalam tiket dan urutan sembang. Penunjuk serta senarai kebenaran ialah segala yang diperlukan oleh dokumen itu.

Semak fail selepas perubahan sebenar atau latihan pemulihan, hapuskan laluan yang tidak lagi wujud dan catat siapa yang bertanggungjawab atas keputusan penyelenggaraan seterusnya. Simpan log perubahan tiga lajur di hujung: tarikh, apa yang berubah, siapa yang mengesahkannya. Halaman itulah yang memberitahu pembaca seterusnya sama ada selebihnya terkini, dan dokumentasi systemctl daripada systemd ialah pautan yang lebih baik daripada parafrasa arahan perkhidmatan yang akan melencong.

Artikel berkaitan