summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorKali Kaneko <kali@leap.se>2017-12-05 23:15:45 +0100
committerKali Kaneko <kali@leap.se>2017-12-07 21:00:03 +0100
commit90e72e19989f9ccb5e3109e16459865b8075c009 (patch)
treeee60c7fd8f945d3438a78a3700c65d33d17bc933 /docs
parentf6bf1920f9218928c0a9dea14db76e730dda770e (diff)
[docs] document how to run osx tests
using virtualbox executor for gitlab-runner
Diffstat (limited to 'docs')
-rw-r--r--docs/hacking/osx-virtualbox.rst68
1 files changed, 68 insertions, 0 deletions
diff --git a/docs/hacking/osx-virtualbox.rst b/docs/hacking/osx-virtualbox.rst
new file mode 100644
index 00000000..ad300644
--- /dev/null
+++ b/docs/hacking/osx-virtualbox.rst
@@ -0,0 +1,68 @@
+.. _osx-vms:
+
+OSX Virtualization
+============================================
+
+If you have acess to a OSX machine, you can setup virtual machines for setting up a gitlab runner.
+
+Base Image
+----------
+
+.. note: convert this to ansible script or similar.
+
+* Install homebrew (via the curl | sh script).
+
+Install basic packages::
+
+ brew install gpg1 wget openssl cryptography python
+
+* Modify $PATH (.bash_profile), source it or login again to activate the PATH.
+
+* Add a symlink from gpg1 to ``/usr/bin/gpg``
+
+Install tox for the tests::
+
+ pip install tox
+
+* Copy ssh keys to access this machine.
+
+* TODO - install virtualbox guest extensions.
+
+
+Gitlab runner (on host)
+-----------------------
+
+* install gitlab-runner for osx [link]
+* install virtualbox in the host machine
+* configure ``.gitlab-runner/config.toml``
+
+Run::
+ gitlab-runner run
+
+Debug mode::
+ gilab-runner --debug run
+
+
+Virtualbox cheatsheet
+---------------------
+
+Some useful commands::
+
+ # list
+ VBoxManage list vms
+ # only running
+ VBoxManage list runningvms
+ # start headless
+ VBoxManage startvm yosemite --type headless
+ # poweroff
+ VBoxManage controlvm yosemite poweroff
+
+gitlab-runner keeps a snapshot with the name 'Base State', so it seems this is
+the one you have to be sure that you modify with all the software you need.
+It seems to me that if you just delete the first 'Base State' snapshot in the
+snapshot sequence, it take the most recent state (virtualbox does a merge).
+
+This is how ``gitlab-runner`` accesses ssh::
+
+ VBoxManage modifyvm yosemite-runner-deadbeef --natpf1 gustssh,tcp,127.0.0.1,99999,,22
+