Setelah proyek berjalan secara lokal, empat perintah akan membawanya ke situs langsung di hosting Zinn Digital®: masuk, tautkan proyek ke slot hosting, baca pra-pemeriksaan (pre-flight), dan dorong (push). Artikel ini membahas masing-masing perintah tersebut, apa yang ditampilkannya, dan perintah yang Anda gunakan setelahnya — penerapan ulang (redeploy), riwayat penerapan, serta log build.
Masuk dengan kunci API
Buat kunci di dasbor pada Pengaturan → Kunci API, kemudian:
zinnector login
Kunci diketikkan pada prompt — kunci tersebut tidak pernah diterima di baris perintah, sehingga tidak akan berakhir di riwayat shell atau daftar proses Anda. Di CI, alirkan melalui pipe: echo "$ZINN_API_KEY" | zinnector login --profile ci, atau tetapkan ZINNECTOR_TOKEN dan lewati login sepenuhnya. Kunci diverifikasi sebelum disimpan, dan disimpan dengan mode berkas 600. zinnector whoami --scopes menunjukkan organisasi mana yang Anda masuki dan izin apa saja yang dimiliki kunci tersebut; kunci sandbox akan dilabeli sebagaimana mestinya.
Tautkan proyek ke slot
zinnector link # pilih situs dari daftar
zinnector link example.com --repo acme/site --branch main
link menuliskan id situs ke dalam zinnector.json dan, kecuali Anda menyertakan argumen --no-repo, menghubungkan remote git proyek ke situs di platform sehingga tindakan push akan menerapkannya. Lakukan commit pada zinnector.json: rekan kerja yang mengkloning repositori tersebut kemudian dapat menerapkannya ke tempat yang sama tanpa perlu diberi tahu. Berkas ini tidak memuat rahasia apa pun.
Baca pra-pemeriksaan
zinnector check
Ini adalah perintah utama tujuan dibuatnya CLI ini. Perintah ini membandingkan proyek Anda dengan slot tempat proyek tersebut akan diterapkan dan menampilkan setiap ketidakcocokan — serta setiap perbandingan yang tidak dapat dilakukannya:
- Versi PHP, dengan selisih versi utama yang dinilai tinggi karena hampir pasti merusak situs dan selisih minor yang dinilai lebih rendah, karena menilai semuanya sebagai kritis membuat orang terbiasa mengabaikan peringatan.
- Apakah slot tersebut dapat beralih ke versi yang Anda gunakan saat membangun, apakah PHP pada slot tersebut telah melewati akhir masa pakai, dan apakah mesin telah menerapkan versi tersebut atau sekadar baru diberi tahu.
- Ukuran dan jumlah berkas proyek Anda terhadap sisa kapasitas disk dan inode yang sebenarnya tersisa pada slot — struktur WordPress dapat kehabisan berkas meski kapasitas disknya masih mencukupi.
- Versi WordPress di kedua sisi, apakah slot telah selesai melakukan provisi, dan apakah repositori telah terhubung untuk menerima push.
Perintah ini memberi peringatan; tidak pernah memblokir. Setiap temuan dapat ditimpa dengan zinnector push --force, karena Anda mengetahui hal-hal tentang situs Anda sendiri yang tidak diketahui oleh pemeriksa. Perbandingan yang tidak dapat dilakukan akan dilaporkan sebagai tidak diketahui (unknown), tidak pernah sebagai berhasil (pass), dan ringkasan selalu menyebutkan berapa banyak hal tersebut terjadi. Secara default, versi PHP lokal adalah versi yang dideklarasikan dalam zinnector.json; --probe akan menjalankan runtime lokal dan mengukurnya secara langsung. --strict juga menghasilkan kode keluar non-nol pada status tidak diketahui, yang memang diperlukan sebagai gerbang CI.
Push
zinnector push
push menjalankan pra-pemeriksaan, mendorong commit Anda, memicu penerapan dan memantaunya hingga selesai, menampilkan status akhir serta commit yang diterapkan. --dry-run melakukan segalanya kecuali penerapan; --no-wait memicunya lalu keluar; --no-git menerapkan apa pun yang sudah ada di platform tanpa melakukan push. Jika commit yang diterapkan bukan yang baru saja didorong, perintah ini akan menyatakannya.
Saat terjadi masalah
zinnector deploys example.com # riwayat penerapan — status, commit, pemicu, pesan
zinnector logs example.com --build # log build dari penerapan terbaru
zinnector logs example.com --error # log kesalahan situs
zinnector deploy example.com # terapkan ulang apa yang sudah ada di platform
zinnector ai "why is my deploy failing?"
zinnector ai berjalan di platform pada akun Anda sendiri, sehingga dapat melihat riwayat penerapan dan log yang sama. Dari dalam proyek, perintah ini mengirimkan struktur proyek — nama direktori, versi, dan id situs — dan tidak pernah mengirimkan konten berkas.
Terkait