Package: voxrow
VOXROWDaftar isi:VOXROWInstalasi dan Cara Penggunaan VOXROWMacOS Hanya JikaErrorServerSource-codeEditorRepositori GitTata Cara PenulisanMarkdownPythonLisensiInstalasi dan Cara Penggunaan VOXROW$pipinstallvoxrowContoh cara penggunaan VOXROW dapat dilihat diexample/example.ipynb.MacOS (Hanya JikaError)Pastikanclangsudah terinstal. Jika tidak, maka jalankan perintah berikut ini:$xcode-select--installInstal VOXROW dengan perintah berikut ini:$brewinstallopenssl@3rust&&envLDFLAGS="-L$(brew--prefixopenssl@3)/lib"CFLAGS="-I$(brew--prefixopenssl@3)/include"pipinstall"voxrow[query]"ServerDisarankan untuk menggunakanUbuntu 18.04 x64(CPUminimal 1 vCore,RAMminimal 512 MB,Storageminimal 10 GB SSD, danBandwidthminimal 500 GB), supaya memudahkan pengelolaanserverdengan mengunakanscriptVOXROW. Adapun langkah yang harus dipersiapkan adalah sebagai berikut:Pastikan telah adasource-codeVOXROW di komputer lokal danserver. Dapat
dipergunakan perintahGitberikut ini:$gitclone--recurse-submodules-j8https://gitlab.com/voxrow/library.gitJangan jalankan perintah ini difolderroot/milikserver!Masuk kefolderserver/:$cdvoxrow/src/server/PastikanGNU Makesudah ada, dengan
menjalankan perintah ini:$.install/make_gnu.shScriptini hanya dapat dipergunakan di Ubuntu Linux, instalasi untuk OS
selain ini silahkan cari di internet.Jalankan perintah di komputer lokal danserversebagai berikut:Komputer lokal:Pastikan terlebih dahulu bahwaSSH Key Pairsudah dibuat, baca baik-baik
instruksi dalam prosesnya! Berikut ini adalah perintahnya:$sudossh-keygenSalinpublic keykomputer lokal keserverdengan perintah ini:$makelocal_ssh_key_to_serverIkuti instruksi yang dimintakan saat proses berjalan.Masukkan alamatserverdanusernameroot.Server:Pastikan anda masuk sebagaiusernameroot!$makeIkuti instruksi yang dimintakan saat proses berjalan. Setelah proses berakhirserverakanreboot. Selesairebootmasuk kembali denganusernamebaru yang telah dibuat.GitLab CI/CDdipergunakan untuk mempermudah
prosesreleaseaplikasi. RegistrasiGitLab Runnerdiprivate serverperlu dilakukan untuk prosesCI/CD,
berikut adalah perintahnya:$makeregister_runnerSetelah seluruh proses selesai dijalankan, maka hapuslahsource-codeVOXROW dariserver, karena sudah tidak diperlukan lagi. Perintahnya
adalah sebagai berikut:$sudorm-rfvoxrow/Source-codeSebagai catatan beberapa perintah aplikasi di komputer lokal ini dapat berjalan
dengan baik di OS MacOS dan Linux. Adapun untuk OS Windows perlu dilakukan sedikit
penyesuaian.EditorVSCode(Visual Studio Code) dipergunakan untuk
memudahkan dalam penulisansource-code.BeberapaextensionVSCode dipasangkan untuk memudahkan penulisansource-code,
antara lain:Auto Markdown TOCMarkdownlintPython extension for Visual Studio CodeJinjaBetter TOMLRepositori GitGit GUISourcetreedapat
dipergunakan untuk memudahkan pengelolaan repositori, pada sistem operasi Windows
atau MacOS.Branching modelGit-Flowdari Vincent Driessen
dipergunakan untuk memudahkan pengelolaanfeature,release, danhotfixdi
dalam repositori.Tata Cara PenulisanMarkdownBeberapa sumber ini dapat dijadikan acuan tata cara penulisanmarkdown:GitLab: List of supported languages and lexersGitLab MarkdownWikipedia: MarkdownBerkas readme.md yang dibuat oleh Ben StrahanPythonDipergunakanPython 3.8.0(versi minimal).Dalam mengembangkansource-codedi komputer lokal, maka pertamakali perlu dibuatenvirontmentpython dengan langkah berikut ini:Pastikan versi python yang dipergunakan sudah sesuai.$python3-VBuatenvirontmentpython.$python3-mvenvvenvInstruksi terkaitenvirontmentpython yang dapat dipergunakan antara lain:Aktivasi:$.venv/bin/activateKembangkansource-codedengan kondisienvirontmentpython sedang teraktivasi.Deaktivasi:(venv)$deactivatePastikanpustaka pendukungterpasang dienvirontmentpython.(venv)$pipinstall--upgradepip&&pipinstall-rrequirements.txtLisensiLisensi yang dipergunakan adalahMS-RSL(Microsoft Reference Source License).