Mulakan

Deploy, pratonton dan rollback.

Cara push disiarkan, pratonton cabang, kembali ke versi terdahulu, arahan keluaran untuk migrasi, tetapan binaan, deploy hook, mod penyelenggaraan dan kata laluan pratonton.

4 MIN BACAAN

Sebaik sahaja aplikasi disiarkan, anda jarang memerlukan panel untuk menghantar perubahan: push ke cabang dan versi baharu akan disiarkan dengan sendirinya. Artikel ini merangkumi semua perkara di sekitarnya — tab Deploy, Pratonton, tab Proses dan beberapa suis dalam Tetapan.

Deploy automatik pada setiap push

Setiap push ke cabang aplikasi membina commit terkini dan melakukan deploy. Versi baharu bermula di sebelah versi yang sedang berjalan dan hanya menerima pelawat apabila ia menjawab; jika ia gagal bermula, versi sebelumnya terus berjalan dan kami akan memaklumkan anda melalui e-mel (dan Telegram, jika anda telah menyambungkannya).

Push yang dibuat semasa binaan lain masih menunggu dalam baris gilir akan digabungkan ke binaan itu, jadi push yang banyak serentak tidak mewujudkan baris gilir yang panjang.

Anda boleh mematikan ciri ini dalam Tetapan → Deploy setiap push. Apabila dimatikan, anda melakukan deploy dari panel, API atau deploy hook.

Deploy dari panel

Tab Deploy menyenaraikan setiap deploy: apa yang memulakannya (push, panel, rollback, deploy hook), commit, tempoh yang diambil dan statusnya. Klik pada deploy untuk melihat log binaan penuhnya.

Deploy semula menawarkan dua pilihan:

  • Bina commit terkini — mengambil kod terbaharu daripada cabang dan membinanya.
  • Deploy semula versi yang sedang berjalan — menggunakan pemboleh ubah yang diubah, tanpa binaan baharu. Gunakannya selepas menyunting Pemboleh ubah.

Menu di sebelah Buka mempunyai dua tindakan yang sama serta Mula semula.

Rollback

Anda boleh kembali ke mana-mana daripada 5 versi berjaya terakhir. Di tab Deploy, klik Rollback pada versi yang anda mahu dan sahkan. Versi terdahulu dimulakan di sebelah versi semasa dan mengambil alih sebaik sahaja ia menjawab — tiada binaan baharu.

Rollback tidak membatalkan perubahan pangkalan data. Jika keluaran telah mengubah struktur pangkalan data, pulihkan pangkalan data juga — lihat Pangkalan data.

Pratonton untuk cabang

Push ke mana-mana cabang lain mendapat pratontonnya sendiri — alamat berasingan di mana anda boleh menyemak perubahan sebelum ia disiarkan. Bukanya di tab Pratonton.

  • Sehingga 3 pratonton pada satu masa, termasuk dalam harga anda.
  • Pratonton tanpa push baharu selama 7 hari akan dialih keluar. Ia dibuat semula pada push seterusnya ke cabang tersebut.
  • Pratonton hanya mendapat pemboleh ubah yang ditetapkan untuknya — lihat Pemboleh ubah persekitaran.
  • Pratonton dibuat untuk perkhidmatan utama projek, bukan untuk perkhidmatan lainnya.

Kata laluan untuk pratonton

Di tab Pratonton, Kata laluan untuk pratonton → Minta kata laluan. Masukkan nama pengguna dan kata laluan (sekurang-kurangnya 8 aksara). Selepas itu, hanya mereka yang mempunyai kata laluan boleh membuka pratonton; aplikasi itu sendiri kekal terbuka kepada semua.

Arahan keluaran (migrasi)

Tab Proses → Arahan keluaran. Ia dijalankan sekali pada setiap deploy, sebelum versi baharu menerima pelawat — biasanya migrasi pangkalan data. Jika ia gagal, deploy dihentikan dan versi semasa terus berjalan, jadi migrasi yang rosak tidak akan sampai kepada pelawat anda.

Kami mencadangkan arahan bagi framework yang mempunyainya:

FrameworkArahan keluaran yang disyorkan
Laravelphp artisan migrate --force
Djangopython manage.py migrate --noinput
Prisma (Node.js)npx prisma migrate deploy

Guna arahan yang disyorkan mengekalkannya; anda juga boleh memasukkan arahan sendiri atau memilih Tiada. Perubahan berkuat kuasa mulai deploy seterusnya.

Tetapan binaan

Tetapan → Tetapan binaan membolehkan anda menukar apa yang kami kesan:

  • Arahan pemasangan — cth. npm ci
  • Arahan binaan — cth. npm run build
  • Arahan permulaan — arahan yang memulakan aplikasi anda. Ia mesti mendengar pada port dalam $PORT.
  • Folder output — bagi laman web statik, folder yang mengandungi fail yang dibina.
  • Folder projek — bagi repositori yang mengandungi beberapa projek.

Biarkan medan kosong untuk menggunakan apa yang kami kesan. Deploy seterusnya dibina dengan tetapan baharu; Bina sekarang memulakannya serta-merta.

Tetapan juga mengandungi Cabang yang di-deploy.

Deploy hook

Tetapan → Deploy hook → Cipta hook. Deploy hook ialah alamat peribadi: apabila perkhidmatan lain menghantar permintaan POST kepadanya, commit terkini cabang anda dibina dan di-deploy. Kegunaan biasa ialah CMS yang membina semula laman web selepas anda menerbitkan kandungan.

curl -X POST "<alamat hook daripada panel>"
  • Alamat dipaparkan sekali sahaja — salin semasa anda mencipta hook. Sesiapa yang memilikinya boleh memulakan deploy, jadi rahsiakannya.
  • Sehingga 10 deploy sejam bagi setiap hook. Panggilan yang tiba semasa binaan masih menunggu akan digabungkan dengannya.
  • Batalkan menghentikan alamat serta-merta; perkhidmatan yang memanggilnya kemudian memerlukan alamat baharu.

Mod penyelenggaraan

Tetapan → Mod penyelenggaraan → Paparkan halaman penyelenggaraan. Pelawat melihat halaman ringkas dengan mesej anda dan bukannya aplikasi; biarkan mesej kosong untuk memaparkan «Kami sedang membuat sedikit penambahbaikan. Sila kembali sebentar lagi.»

Aplikasi itu sendiri terus berjalan, jadi anda boleh menyemak semuanya sebelum membukanya semula. Pautan peribadi untuk anda memaparkan aplikasi seperti biasa pada peranti yang membukanya, selama 12 jam. Pautan baharu membuat pautan baharu; pautan lama berhenti berfungsi.

Matikan suis untuk membuka aplikasi kepada pelawat semula.

Pemberitahuan tentang deploy

Kami menghantar e-mel kepada anda (dan mesej Telegram, jika anda telah menyambungkannya) apabila deploy tidak selesai. Untuk turut menghantar peristiwa kepada pasukan anda — versi baharu disiarkan, deploy tidak selesai, perkhidmatan berhenti atau pulih, penggunaan memori atau pemproses yang tinggi, sandaran atau cakera pangkalan data — tambah Slack, Discord atau webhook anda sendiri dalam Tetapan → Pemberitahuan kepada pasukan anda. Mesej webhook ialah JSON yang ditandatangani dengan rahsia yang dipaparkan sekali, dalam pengepala X-Rivervo-Signature.

Masih perlukan bantuan?

Bersembang dengan kami — AI menjawab serta-merta dan jurutera menyertai apabila perlu, pada bila-bila masa.

Hubungi sokongan