Tirsvad
2eb852cfc6
The Publish wiki workflow now reads secrets.TOKEN_FOR_GITEA_WIKI || secrets.TOKEN_FOR_GITEA, so the existing token can publish the wiki when it has write:repository. Update the missing-token message, the credentials and troubleshooting guides, the README, the tests and the affected English wiki pages with their Danish and Bahasa Malaysia translations. Task: MIL-005#8
4.9 KiB
Ini ialah terjemahan
Troubleshooting. Halaman bahasa Inggeris ialah teks yang sah, dan perubahan di sini akan ditimpa pada penerbitan wiki yang seterusnya.
English | Dansk | Bahasa Melayu
Mendiagnosis larian yang gagal
Buka larian dalam Gitea (Actions) dan baca baris terakhir langkah yang gagal. Setiap kegagalan daripada skrip penyegerakan ditulis sebagai
ERROR: [<category>] <message>
Kategori menunjukkan di mana perlu dilihat. Kegagalan di luar skrip (kerja tidak pernah bermula, atau berhenti sebelum langkah itu) ialah masalah runner.
| Kategori | Maksud | Perkara pertama yang disemak |
|---|---|---|
configuration |
Secret atau tetapan repositori tiada atau tidak betul bentuknya | Nama dan format secret, penyediaan push mirror |
credentials |
Satu perkhidmatan menolak token (HTTP 401) | Token tamat tempoh, dibatalkan atau tersalah taip |
permissions |
Token sah tetapi tidak dibenarkan (HTTP 403, atau tiada akses pentadbiran GitHub) | Skop token dan akses repositori |
api |
Ralat HTTP lain, atau perkhidmatan tidak dapat dicapai | Status perkhidmatan, rangkaian runner |
| runner | Tiada baris ERROR:; larian menunggu, atau kerja gagal sebelum skrip |
Runner dalam talian, label, alat |
Mesej dan pembetulan
| Mesej (permulaan) | Kategori | Punca dan pembetulan |
|---|---|---|
CREDENTIALS_FOR_GITHUB is missing or empty. |
configuration | Tambah secret |
CREDENTIALS_FOR_GITHUB must contain valid JSON. |
configuration | Nilai mesti JSON seperti {"GITHUB_PAT": "..."} |
CREDENTIALS_FOR_GITHUB must be a JSON object. |
configuration | Gunakan objek, bukan senarai atau rentetan |
CREDENTIALS_FOR_GITHUB must contain a non-empty GITHUB_PAT. |
configuration | Tambah kunci GITHUB_PAT dengan token |
TOKEN_FOR_GITEA is missing or empty. |
configuration | Tambah secret |
TOKEN_FOR_GITEA must contain a non-empty GITEA_TOKEN. |
configuration | Bentuk JSON memerlukan kunci GITEA_TOKEN |
Could not determine the Gitea source repository. |
configuration | Larian tiada nama repositori; laporkan sebagai kecacatan |
Expected at most one GitHub push mirror ... found N |
configuration | Kekalkan satu push mirror GitHub |
No token for the wiki: set TOKEN_FOR_GITEA_WIKI, or TOKEN_FOR_GITEA. |
configuration | Penerbitan wiki sahaja: tambah salah satu secret (lihat credentials.md) |
... HTTP 403 ... semasa menerbitkan wiki |
permissions | Penerbitan wiki sahaja: token memerlukan write:repository dan akses tulis kepada repositori ini |
The wiki is not enabled on <repo> |
configuration | Penerbitan wiki sahaja: aktifkan wiki dalam tetapan repositori |
The wiki source directory ... has no Markdown pages |
configuration | Penerbitan wiki sahaja: wiki/ kosong atau tiada; tiada apa-apa diubah |
Could not determine the GitHub owner and repository ... |
configuration | Alamat cermin mesti kelihatan seperti https://github.com/<owner>/<repo>.git |
Gitea API request failed with HTTP 401 |
credentials | Cipta token Gitea baharu dan kemas kini TOKEN_FOR_GITEA |
GitHub API request failed with HTTP 401 |
credentials | Cipta token GitHub baharu dan kemas kini CREDENTIALS_FOR_GITHUB |
... HTTP 403 ... (Gitea) |
permissions | Token memerlukan read:repository, dan penggunanya mesti pentadbir repositori |
... HTTP 403 ... (GitHub) |
permissions | Token memerlukan Administration read and write pada repositori cermin |
The GitHub token cannot administer <repo> |
permissions | Sama seperti di atas; token boleh membaca repositori tetapi tidak boleh mengeditnya |
... HTTP 404 ... |
configuration | Repositori tidak ditemui, atau token tidak dapat melihatnya; semak alamat cermin dan akses repositori token |
... HTTP 5xx ... |
api | Masalah perkhidmatan; jalankan semula kemudian |
... API is unreachable ... |
api | Masalah rangkaian, DNS atau proksi pada runner |
Bukan satu ralat
No GitHub push mirror configured for <repo>; nothing to sync. Larian berjaya. Tidak semua repositori Gitea mempunyai cermin GitHub, jadi ini dijangka bagi repositori tersebut. Jika repositori itu sepatutnya mempunyainya, tambahkannya dalam tetapan repositori.
WARNING: Gitea returned an invalid push mirror list; GitHub metadata was not synced. Larian berjaya tetapi tiada apa-apa disegerakkan. Semak bahawa versi Gitea menyokong API push mirror dan jalankan semula.
Masalah runner
Lihat bahagian Runners. Ringkasnya: jika larian kekal waiting, tiada runner dalam talian yang mempunyai label itu; jika kerja gagal sebelum skrip, imej runner tiada satu alat.
Menjalankan semula
Gunakan Run workflow (workflow_dispatch) selepas puncanya dibetulkan. Penyegerakan selamat diulang: ia menimpa penerangan dan topik GitHub dengan nilai daripada Gitea.