GitHub Pages akan beralih ke Actions pada akhir Jun 2024

[kmubiin]

Berdasarkan kenyataan rasmi oleh GitHub, diumumkan melalui e-mel bertarikh 3 April 2024, 23:00:

We are writing to inform you about an important update regarding GitHub Pages.

What is happening?

Delivering on our continued commitment to enhance security, protect your data, and deliver an overall improved experience, we will be phasing out our legacy pagesworker architecture by the end of June 2024.

Kenyataan dengan tarikh tamat sokongan boleh didapati di GitHub Docs, seperti laman ini:

Who can use this feature? [...]
All GitHub Pages builds will use GitHub Actions from June 30, 2024. No other changes are required but GitHub Actions must be enabled in your repository for builds to continue. For more information on enabling GitHub Actions, see "Managing GitHub Actions settings for a repository."

Menurut kenyatan rasmi bertarikh 10 Ogos 2022, GitHub Pages kini menggunakan GitHub Actions sejak akhir-2021 untuk menjana dan menerbit laman.

Bagi projek suaikata, beberapa perubahan dan percubaan perlu dilakukan sebelum dapat menjana dan menerbit laman menggunakan GitHub Actions. Perlu ada tetapan baharu dan sintaksis yang lebih rumit dan berjela. Menyusahkan.

Pada masa isu ini ditulis (April 2024), projek suaikata masih menggunakan tetapan lama yang jauh lebih mudah: Build and deployment -- Source: [Deploy from a branch] -- Branch: [asal], [/docs] -- [Save]. Dah siap. Tak perlu fail tetapan atau sintaksis apapun!

Pendek kata, tetapan lama akan dikekalkan sehingga Jun 2024. GitHub Actions? Kalau masih leceh, boleh saja henti jana laman dalam talian. Tengok keadaan dulu.

---

Langkah pertama sudah cukup rumit bagi para pengguna yang hanya mahukan laman dijana dengan (tidak) mudah. GitHub Actions memberi empat pilihan tetapan, yang mana tiga daripadanya adalah "aktifkan" dengan kebenaran yang berbeza:

Actions permissions

1. Allow all actions and reusable workflows Any action or reusable workflow can be used, regardless of who authored it or where it is defined.
2. Disable actions The Actions tab is hidden and no workflows can run.
3. Allow kmubiin actions and reusable workflows Any action or reusable workflow defined in a repository within kmubiin can be used.
4. Allow kmubiin, and select non-kmubiin, actions and reusable workflows Any action or reusable workflow that matches the specified criteria, plus those defined in a repository within kmubiin, can be used. Learn more about allowing specific actions and reusable workflows to run.

Tetapan 2. nyahaktif adalah yang termudah, dan sengaja dipilih untuk projek suaikata pada masa ini (Jun 2024).

Kesan mengubah tetapan Actions apabila menggunakan 'workflow' yang dipilih secara lalai (diselidik pada 8 Ogos 2024):

• Tetapan 1. aktif adalah pilihan yang sah, secara lalai, apabila memilih 'workflow' yang disarankan semasa GitHub Actions mula-mula diaktifkan.
• Jika ubah tetapan 1. menjadi 3. pada masa kemudian, maka 'workflow' yang dipilih secara lalai tidak boleh digunakan dan teks amaran akan muncul di laman tetapan 'Pages' di GitHub.
• Dengan kata lain, tetapan 1. aktif adalah satu-satunya pilihan yang mesti dipilih oleh kebanyakan pengguna biasa, jika 'workflow' itu bergantung pada repositori luar seperti actions/* secara lalai.

---

Aturan menjana laman menggunakan GitHub Actions, dan sama ada rancangan diteruskan hingga akhir (TAMAT) atau tidak diteruskan (DIABAI):

• [x] (MULA) nyahaktif tetapan lama bagi menjana laman pada dahan tertentu, selewat-lewatnya hari Ahad, 30 Jun 2024
• [ ] cipta dahan baru--"laman" atau nama yang sesuai--daripada dahan asal pada titik permulaan, seperti git checkout -b 0.0 laman
• [ ] kemas kini README.md bagi dahan baru untuk menyatakan kegunaan dan langkah-langkah menyedia laman untuk dijana daripada dahan asal
• [ ] aktif semula GitHub Actions daripada tetapan repositori projek ini
• [ ] mulanya perlu tambah peraturan baru di GitHub - Settings - Environments: github-pages terlebih dahulu, jika dahan diberi nama selain 'main' atau 'gh-pages'
• [ ] kemudian perlu cipta tetapan fail melalui tetapan repositori projek ini--sama ada menggunakan laman Jekyll atau laman HTML sahaja--dan namakan seperti .github/workflow/laman.yml
• [ ] (TAMAT) salin sumber laman Jekyll atau laman HTML yang dijana terlebih dahulu di localhost daripada dahan asal--GitHub Actions akan jana/terbit laman mengikut tetapan yang dicipta sebelum ini--rancangan berakhir
• [x] (DIABAI) semak semula keadaan laman projek--rancangan tidak diteruskan

[kmubiin]

Komen sendiri (berkaitan isu ini, tetapi di luar tugasan)

Menjana laman di Pages tertakluk pada had penggunaan yang sedia maklum. Oleh sebab Pages kini menggunakan Actions, menjalankan 'workflow' juga ada had penggunaan tambahan yang lebih rumit.

Had pembinaan laman menurut laman maklumat Pages:

GitHub Pages sites are subject to the following usage limits:

• ...
• GitHub Pages sites have a soft limit of 10 builds per hour. This limit does not apply if you build and publish your site with a custom GitHub Actions workflow.
• ...

Had penggunaan 'workflow' menurut laman maklumat Actions:

GitHub Actions usage is free for standard GitHub-hosted runners in public repositories, and for self-hosted runners [...]

Included storage and minutes
Plan Storage Minutes (per month) GitHub Free 500 MB 2,000 ...

Minute multipliers Operating system Minute multiplier Linux 1 Windows 2 macOS 10

Pengguna dengan akaun percuma (GitHub Free), secara lalai, akan menggunakan sistem Linux yang ada gandaan minit satu (1).

Apabila menjalankan 'workflow' yang disarankan bagi pengguna baharu, percubaan sendiri (setakat Ogos 2024) mendapati bahawa setiap kali:

• gagal menjalankan 'workflow' (failed to deploy), tetap mengambil masa 1s
• lulus menjalankan 'workflow' bagi memuat laman (deployed with static content), mengambil masa sekurang-kurangnya 9s hingga belasan saat
• lulus menjalankan 'workflow' bagi membina dan memuat laman (deployed with Jekyll), mengambil masa hampir 20s atau beberapa puluhan saat

Bagi projek suaikata, tiada keperluan untuk membina dan memuat laman di Pages menggunakan Actions. Menjana laman di localhost juga akan dipermudah dan diterhad sebelum projek ini boleh dilupakan dan beralih ke projek yang lebih bermakna.