Menggunakan Deployment GitHub di WordPress.com

GitHub Deployments mengintegrasikan repositori GitHub secara langsung dengan situs WordPress.com Anda, sehingga menyediakan alur kerja otomatis yang dikontrol versi untuk menerapkan plugin, tema, atau perubahan situs lengkap. Panduan ini mencakup proses penyiapan dan cara mengelola repositori Anda yang terhubung.

Fitur ini tersedia di situs dengan paket WordPress.com Bisnis dan Commerce. Jika Anda menggunakan paket Bisnis, pastikan untuk mengaktifkannya. Untuk situs gratis dan situs dengan paket Personal dan Premium, upgrade paket Anda untuk mengakses fitur ini.

Video ini dalam bahasa Inggris.
YouTube memiliki fitur terjemahan otomatis sehingga Anda dapat menontonnya dalam bahasa Anda:

Untuk menampilkan subtitel terjemahan otomatis:

1. Putar video.
2. Klik ⚙️ Pengaturan (di kanan bawah video).
3. Pilih Subtitel/CC.
4. Pilih Terjemahkan otomatis.
5. Pilih bahasa yang Anda inginkan.

Untuk mendengarkan sulih suara otomatis (eksperimental):

1. Klik ⚙️ Pengaturan.
2. Pilih Trek audio.
3. Pilih bahasa yang ingin Anda dengarkan:

ℹ️ Terjemahan dan sulih suara dibuat secara otomatis oleh Google, mungkin tidak sepenuhnya akurat, dan fitur sulih suara otomatis masih dalam tahap uji coba sehingga belum tersedia untuk semua bahasa.

Sebelum dapat menerapkan repositori GitHub ke situs WordPress.com, Anda harus terlebih dahulu menyiapkan koneksi antara keduanya dengan langkah-langkah berikut:

1. Kunjungi halaman Situs Anda: https://wordpress.com/sites/
2. Klik nama situs Anda untuk melihat ikhtisar situs.
3. Klik pada tab Deployment.
4. Klik tombol “Hubungkan repositori“. Lalu, jika melihat repositori yang terdaftar, Anda telah menghubungkan akun GitHub Anda. Lanjutkan ke langkah 11.
5. Klik tombol “Instal aplikasi WordPress.com“.
6. Jendela baru akan terbuka, dan Anda akan diminta untuk login ke akun GitHub jika Anda belum melakukannya. Lalu Anda akan melihat layar ini:

7. Klik tombol “Otorisasi WordPress.com for Developers“.
8. Pilih organisasi atau akun GitHub tempat repositori Anda berada.
9. Pilih satu repositori atau lebih yang ingin Anda hubungkan:
   • Semua repositori: Memilih opsi ini akan memberikan akses WordPress.com ke semua repositori saat ini dan mendatang yang dimiliki oleh akun GitHub yang dipilih. Ini mencakup repositori publik yang bersifat baca-saja.
   • Hanya pilih repositori: Dengan memilih opsi ini, Anda dapat memilih repositori mana yang dapat diakses WordPress.com di akun GitHub yang dipilih. 
10. Setelah Anda memilih opsi, klik tombol Instal.
11. Jendela baru akan ditutup dan Anda akan diarahkan kembali ke WordPress.com. Satu repositori atau lebih yang Anda pilih harus terdaftar bersama akun GitHub yang terkait dengan repositori tersebut:

12. Klik Pilih di samping repositori yang ingin dihubungkan.

Saat ini, Anda akan melihat WordPress.com for Developers di bawah Aplikasi GitHub Terotorisasi dan Aplikasi GitHub Terinstal.

Setelah memilih repositori, Anda perlu menyesuaikan pengaturan deployment:

• Cabang deployment: Secara default akan menggunakan cabang repositori default (biasanya utama) tetapi dapat diubah menjadi cabang yang ingin Anda gunakan.
• Direktori tujuan: Folder server tempat Anda ingin menerapkan berkas. Untuk plugin, ini berupa /wp-content/plugins/my-plugin-name. Untuk tema, ini berupa /wp-content/themes/my-theme-name. Untuk deployment situs sebagian (yaitu, beberapa plugin atau tema), Anda dapat menggunakan /wp-content. Konten repositori akan digabungkan dengan konten situs WordPress yang sudah ada di direktori yang ditentukan.
• Deployment otomatis: Terdapat dua cara untuk penerapan ke WordPress.com:
  • Otomatis: Setelah kode tersebut diterapkan, kode akan dikirimkan ke situs WordPress.com Anda. Deployment otomatis direkomendasikan untuk situs staging.
  • Manual: Kode akan diterapkan setelah Anda meminta deployment. Deployment manual direkomendasikan untuk situs produksi.
• Mode deployment: Terdapat dua tipe deployment:
  • Sederhana: Mode ini akan menyalin semua berkas dari cabang repositori ke situs dan menerapkannya tanpa pasca-pemrosesan.
  • Tingkat Lanjut: Dengan mode ini, Anda dapat menggunakan skrip alur kerja, memungkinkan langkah-langkah pembangunan kustom seperti menginstal dependensi Composer, melakukan pengujian kode pra-deployment, dan mengontrol deployment berkas. Ideal untuk repositori yang membutuhkan perangkat lunak Composer atau Node. Lihat Deployment Tingkat Lanjut di bawah ini untuk informasi selengkapnya.

Setelah semua pengaturan dikonfigurasi, klik tombol Hubungkan. Repositori Anda akan ditambahkan:

Perhatikan bahwa Anda harus memicu deployment pertama, baik secara otomatis maupun manual. Anda kemudian dapat menghubungkan repositori lain kapan saja dengan mengklik tombol “Hubungkan repositori“.

Dengan Deployment Tingkat Lanjut, Anda dapat menyediakan skrip alur kerja untuk memproses berkas di repositori Anda sebelum deployment. Hal ini membuka banyak kemungkinan, seperti memeriksa kode untuk memastikan kode tersebut memenuhi standar pengodean tim Anda, menjalankan pengujian unit, mengecualikan berkas dari deployment, menginstal dependensi, dan banyak lagi. Untuk memulai, lihat resep alur kerja kami.

Untuk menyiapkan Deployment Tingkat Lanjut:

1. Formulir akan muncul tempat Anda bisa mengonfigurasi deployment.
2. Klik nama repositori untuk mengelola koneksi.
3. Di sisi kanan, di bawah “Pilih mode deployment Anda“, pilih Tingkat Lanjut.

4. Jika repositori sudah berisi berkas alur kerja, Anda dapat memilihnya di sini. Sistem akan memeriksa berkas untuk mengetahui ada tidaknya error. Jika tidak ditemukan error, lanjutkan ke langkah 7.
5. Anda juga dapat memilih opsi “Buat alur kerja baru” untuk menambahkan berkas alur kerja yang telah dikonfigurasi sebelumnya. Memilih opsi ini akan menimpa berkas alur kerja wpcom.yml jika sudah ada di repositori Anda.
6. Klik tombol “Instal alur kerja untuk saya” untuk menerapkan berkas alur kerja ke repositori.
7. Setelah alur kerja ditambahkan dan diverifikasi, klik Perbarui. Repositori Anda sekarang akan menggunakan deployment tingkat lanjut.

Setelah menghubungkan repositori GitHub Anda ke sebuah situs, langkah selanjutnya adalah menerapkan kode Anda. Ada dua metode deployment yang tersedia: Otomatis dan Manual.

Deployment otomatis tidak direkomendasikan untuk situs produksi aktif, karena perubahan kode di repositori akan secara otomatis diterapkan dari GitHub ke situs aktif. Sebaliknya, pertimbangkan untuk menyiapkan deployment otomatis ke situs staging dan menyinkronkannya ke produksi setelah Anda siap.

Deployment manual memberikan kontrol lebih saat perubahan kode diluncurkan ke situs aktif, karena Anda perlu memicu setiap deployment secara manual. Kami menyarankan deployment manual jika Anda tidak ingin menggunakan situs staging.

Untuk memicu deployment secara manual:

1. Buka halaman Situs Anda: https://wordpress.com/sites/
2. Klik nama situs Anda untuk melihat ikhtisar situs.
3. Klik pada tab Deployment.
4. Klik menu elipsis (⋮) pada repositori yang ingin Anda terapkan.
5. Pilih “Picu deployment manual“. Anda akan melihat pemberitahuan banner bertuliskan, “Pengaktifan deployment telah dibuat”, dan status deployment akan berubah menjadi “Diantrekan”.
6. Tunggu sampai deployment selesai (status akan berubah menjadi “Telah Diterapkan”).

7. Klik menu elipsis (⋮) lagi lalu pilih “Lihat pemrosesan deployment“. 
8. Log pemrosesan deployment menampilkan Penulis dan penerapan yang dilakukan. Jika mengeklik entri pemrosesan deployment, Anda dapat melihat informasi selengkapnya.

Untuk mengelola koneksi repositori GitHub Anda yang sudah ada:

1. Buka halaman Situs Anda: https://wordpress.com/sites/
2. Klik nama situs Anda untuk melihat ikhtisar situs.
3. Klik pada tab Deployment.
4. Anda kemudian akan melihat daftar koneksi. 

Daftar koneksi ditampilkan jika terdapat setidaknya satu koneksi antara repositori GitHub dan situs Anda. Daftar ini mencakup informasi yang relevan untuk setiap koneksi, seperti nama repositori dan cabang, pelaksanaan terakhir yang diterapkan ke sebuah situs, waktu penerapan, lokasi penempatan kode, waktu pemrosesan deployment, dan statusnya.

Ada tindakan tambahan yang perlu dilakukan setelah mengeklik menu elipsis (⋮):

• Picu deployment manual: Memulai pemrosesan deployment pada tindakan terbaru dari cabang yang telah dikonfigurasi.
• Lihat pemrosesan deployment: Membuka tampilan log pemrosesan deployment untuk repositori yang terhubung.
• Konfigurasikan koneksi: Membuka tampilan kelola koneksi untuk repositori.
• Putuskan koneksi repositori: Menghapus koneksi antara repositori dan situs.

Log pemrosesan deployment memberikan catatan terperinci langkah demi langkah dari setiap deployment, baik dipicu secara otomatis atau manual. Log ini membantu Anda melacak perubahan, memantau status deployment, dan memecahkan masalah apa pun yang muncul. Dengan akses ke log dari 10 pemrosesan terakhir dalam 30 hari, Anda bisa dengan mudah meninjau kejadian selama setiap deployment dan memastikan semua berjalan lancar.

Untuk memeriksa log deployment:

1. Buka halaman Situs Anda: https://wordpress.com/sites/
2. Klik nama situs Anda untuk melihat ikhtisar situs.
3. Klik pada tab Deployment.
4. Klik menu elipsis (⋮) di sebelah repositori yang lognya ingin Anda lihat.
5. Pilih “Lihat pemrosesan deployment“.
6. Tampilan daftar Pemrosesan deployment menampilkan tindakan yang diterapkan ke situs, status deployment, tanggal, dan durasi.
7. Klik di mana pun saat pemrosesan untuk memperluas dan melihat informasi lengkap tentang deployment.

Log memberikan catatan semua perintah yang dieksekusi, mulai dari mengambil kode dari GitHub hingga menempatkannya di direktori target. Anda dapat memperluas baris log untuk melihat informasi lengkap dengan mengeklik “tampilkan selengkapnya“.

Saat memutus koneksi repositori GitHub dari situs Anda, perubahan apa pun di masa mendatang pada repositori tidak akan memengaruhi situs Anda. Secara default, berkas yang disebarkan akan tetap berada di situs Anda, tetapi Anda memiliki opsi untuk menghapusnya selama proses pemutusan.

Untuk menghapus repositori:

1. Buka halaman Situs Anda: https://wordpress.com/sites/
2. Klik nama situs Anda untuk melihat ikhtisar situs.
3. Klik pada tab Deployment.
4. Klik menu elipsis (⋮) pada repositori.
5. Pilih “Putuskan koneksi repositori“.
6. Jendela dialog akan muncul. Klik pengalih untuk menghapus berkas terkait dari situs.
7. Klik “Putuskan koneksi repositori” untuk menutup dialog dan memutus koneksi repositori.

Perhatikan bahwa WordPress.com for Developers akan tetap muncul di Aplikasi GitHub Terinstal dan Aplikasi GitHub Terotorisasi. Hal ini karena WordPress.com masih memiliki akses ke repositori, tetapi koneksinya telah dihapus.

Anda juga dapat memilih untuk mencabut akses WordPress.com ke akun GitHub. Anda dapat melakukannya kapan saja dengan mengunjungi Pengaturan Aplikasi di GitHub. 

Untuk mencabut akses aplikasi terotorisasi ke akun GitHub Anda:

1. Buka Aplikasi GitHub Terotorisasi.
2. Klik Cabut di sebelah WordPress.com for Developers.
3. Klik tombol “Saya mengerti, cabut akses“.

Meskipun Anda mencabut akses aplikasi terotorisasi, kode masih dapat diterapkan karena aplikasi WordPress.com for Developers tetap terinstal di akun terpilih.

Untuk mencabut akses instalasi WordPress.com dan menonaktifkan kemampuan untuk menerapkan kode ke situs WordPress.com Anda:

1. Buka Aplikasi GitHub Terinstal.
2. Klik Konfigurasikan di sebelah WordPress.com for Developers.
3. Di area Zona bahaya , klik Hapusinstalan, lalu klik OK bila diminta.

Menghapus WordPress.com dari daftar aplikasi terotorisasi tidak berarti bahwa repositori akan dihapus atau tidak berfungsi; repositori Anda akan tetap ada di GitHub setelah Anda mencabut akses WordPress.com, tetapi WordPress.com tidak akan dapat lagi menerapkan kode.