SSH Access ke Repository GIT
Dengan platform ini, Anda dapat dengan mudah melakukan deployment aplikasi dari repository GIT/SVN publik atau privat untuk setiap bahasa pemrograman yang didukung: Java, PHP, Ruby, Python, dan Node.js.
Untuk mencapai keamanan lebih, Anda juga dapat mengakses repository GIT privat Anda melalui SSH dan dengan mudah meng-clone dan memperbarui aplikasi Anda dari sana. Selain itu, ini memberikan kemampuan untuk bekerja dengan repository tersebut, yang berada di server privat, bukan layanan hosting web berbasis umum seperti GitHub, GitLab, Bitbucket, dll.
Untuk mengakses repository GIT privat Anda menggunakan protokol SSH yang aman, ikuti langkah-langkah sederhana di bawah ini:
- Buat Keychain SSH
- Tambahkan Kunci SSH Privat ke Akun Platform
- Tambahkan Kunci SSH Publik ke Akun Git
- Deploy Proyek via SSH
Buat Keychain SSH
Untuk memulai, Anda perlu membuat pasangan kunci SSH (yaitu dua kunci terkait: privat dan publik) untuk mengaitkan repository GIT Anda ke akun PaaS. Ikuti instruksi Buat Kunci SSH jika Anda belum pernah membuat keychain sebelumnya.
Kunci Anda tidak boleh mengandung perlindungan kata sandi (passphrase) agar dapat digunakan untuk menjalin koneksi antara platform dan akun GIT.
Tambahkan Kunci SSH Privat ke Akun Platform
Setelah Anda mendapatkan pasangan kunci SSH yang dihasilkan, mari tempatkan masing-masing di sistem yang sesuai. Pertama-tama, Anda perlu menambahkan kunci privat Anda ke akun PaaS.
- Masuk ke akun PaaS Anda dan arahkan ke pengaturannya dengan mengklik tombol Settings dengan nama yang sama di bagian kanan atas dashboard.
- Di dalam tab Pengaturan Pengguna yang terbuka, beralih ke opsi SSH Keys > Private Keys dan klik tombol Add Private Key.
- Salin kunci SSH privat Anda dan tempelkan ke dalam kolom teks Key. Lalu ketikkan sebuah Name untuk kunci ini (misalnya git-key) dan selesaikan penambahan dengan tombol Add.
Jika Anda menerima kesalahan saat menambahkan kunci, pastikan kunci tersebut tidak dilindungi dengan passphrase. Jika iya, hilangkan perlindungan tersebut dan coba lagi.
- Hasilnya, kunci privat baru Anda akan muncul di tab yang sesuai dalam sesaat.
Anda selalu dapat menghapus kunci Anda jika kunci tersebut tidak diperlukan lagi - cukup klik tombol silang merah yang sesuai. Penghapusan kunci dari manajer tidak akan menghapusnya dari proyek GIT yang ada di platform. Oleh karena itu, Anda akan tetap dapat bekerja dengan cara yang sama seperti sebelumnya.
Tambahkan Kunci SSH Publik ke Akun Git
Setelah kunci privat Anda diunggah ke akun PaaS, saatnya untuk menyesuaikan akun repository GIT Anda.
Jika repository GIT Anda terletak di server privat yang jauh, cukup unggah kunci SSH publik yang sesuai dan tambahkan ke daftar kunci yang diizinkan.
Jika Anda menggunakan layanan hosting proyek berbasis web, ikuti panduan langkah demi langkah yang sesuai di bawah ini. Sebagai contoh, kami akan memfokuskan perhatian pada tiga layanan paling populer:
GitHub
- Masuk ke akun GitHub Anda menggunakan kredensial Anda. Pergi ke Settings akun (di pojok kanan atas), pilih tab SSH and GPG keys di panel kiri, dan klik tombol New SSH key.
- Tempelkan kunci SSH publik Anda ke kolom input Key, atur Title untuk kunci Anda (misalnya jelastic-sshkey), dan klik Add SSH key.
- Konfirmasikan penambahan dengan mengetikkan kata sandi untuk akun GitHub Anda di bingkai yang terbuka dan memilih tombol yang sesuai.
- Periksa kunci yang baru ditambahkan telah muncul di tab SSH keys yang sama.
- Untuk mendapatkan tautan SSH ke proyek Anda, arahkan ke repository yang diinginkan (Anda harus masuk) dan ganti jenis tautan ke SSH di bagian clone URL di panel kanan. Lalu klik tombol Copy to clipboard (atau lakukan secara manual).
GitLab
- Masuk ke akun GitLab Anda. Akses Settings akun (di pojok kanan atas) dan masuk ke tab SSH Keys di menu sebelah kiri.
- Tempelkan kunci SSH publik Anda ke kolom input Key, atur Title (misalnya jelastic-sshkey), dan tanggal Expires at (opsional) untuk kunci Anda.
Tanggal kedaluwarsa bersifat informatif dan tidak mencegah Anda menggunakan kunci tersebut. Misalnya, dapat digunakan oleh administrator untuk menjaga kunci tetap berotasi.
Klik tombol Add key.
- Kunci Anda seharusnya muncul dalam daftar Your SSH keys di bawahnya.
- Untuk mendapatkan tautan SSH ke proyek Anda, navigasikan ke repository yang diinginkan (Anda harus masuk), perbanyak menu Clone dan salin tautan Clone with SSH.
Bitbucket
- Masuk ke akun Bitbucket menggunakan kredensial Anda dan pilih opsi Manage Account dari menu pengaturan pengguna di pojok kanan atas halaman.
- Setelah halaman pengaturan akun terbuka, beralih ke tab SSH keys (di dalam bagian Security) menggunakan daftar kategori di sebelah kiri. Kemudian, pilih Add key di bagian tengah halaman.
- Di bingkai yang muncul, tempelkan kunci SSH publik Anda ke kolom input Key, atur Label untuk kunci Anda (misalnya jelastic-sshkey), dan klik tombol Add key.
- Periksa kunci yang baru ditambahkan telah muncul di tab SSH keys yang sama.
- Untuk mendapatkan tautan SSH ke proyek Anda, akses layar ikhtisar repository yang diinginkan (Anda harus masuk) dan ganti jenis tautan ke SSH dalam daftar drop-down yang sesuai di bagian atas halaman. Salin string yang ditampilkan.
Deploy Proyek via SSH
Akhirnya, sekarang Anda bisa melanjutkan dengan deployment proyek Anda melalui koneksi yang aman.
- Pergi ke Deployment Manager di bagian bawah dashboard dan klik Add repo. Berikan informasi berikut dalam formulir yang terbuka:
- Name - nama dari aplikasi Anda (tidak diperbolehkan spasi dan simbol khusus)
- URL - URL git yang sesuai ke repository
- Branch - cabang yang diperlukan dari proyek (master secara default)
- centang kotak Use Authentication, pilih opsi SSH Key sebagai Access Type Anda, dan Select Key dari daftar
Klik Add untuk menyimpan informasi proyek Anda.
- Begitu proyek ditambahkan ke Deployment Manager, arahkan kursor di atasnya dan gunakan tombol Deploy to yang muncul untuk melaksanakan deployment aplikasi Anda.
Dalam jendela yang terbuka, Anda perlu menentukan target deployment dan beberapa konfigurasi tambahan:
- Environment - pilih environment target dari daftar
Untuk environment berbasis Java, Anda perlu memilih node build secara tambahan.
- Path - ketik konteks yang Anda ingin aplikasi Anda dideploy ke (atau biarkan yang default)
- Hooks - tambahkan operasi pre- dan post-deployment (jika diperlukan)
- Check and auto-deploy updates - memungkinkan pembaruan berkala otomatis dari proyek Anda dari repository (dilakukan hanya jika ada perubahan kode) dengan interval yang ditetapkan
- Auto-resolve conflicts - menghindari konflik penggabungan, perintah “git reset –hard” akan dipanggil selama pembaruan proyek berikutnya (file yang bertentangan akan diperbarui sesuai versi repository, mengabaikan perubahan yang dilakukan di lokal)
- Enablezero-downtime deployment - menyesuaikan alur deployment untuk menghindari downtime aplikasi (untuk server PHP saja)
Ketika semua data telah dimasukkan, klik Deploy untuk melanjutkan dan tunggu sampai proyek Anda berhasil dideploy.
- Anda dapat memastikan file proyek Anda sekarang tersedia. Buka Configuration File Manager untuk environment Anda, pergi ke direktori webroot dan periksa folder dengan nama sesuai konteks yang ditentukan (ROOT secara default) di dalamnya.
- Akhirnya, Anda dapat mengklik Open in Browser untuk environment Anda dan pastikan aplikasi Anda berjalan.
Itu saja! Nikmati interaksi yang sangat terlindungi dengan sistem kontrol versi mana pun - clone dan perbarui proyek Anda, yang dihosting di platform, secara langsung dari repository GIT privat Anda melalui SSH.