FLETCHER 420c19433f docs: Add Windows help with vagrant
Some users that run vagrant on their Windows machine may need to update
some git configurations prior to running vagrant up. This adds a note
for the steps.

Change-Id: If6ae8495802eb20883a5f0615f8d8c15d28f05fe
2021-02-18 18:56:50 +00:00

2.4 KiB

Jarvis AIO Vagrant

Checkout Repository

Checkout the Jarvis AIO repository using git:

git clone "https://review.opendev.org/airship/charts"

Installation

A vagrant file is provided under tools/deployment/vagrant, running vagrant up from this directory should bring up and deploy a copy of the Jarvis AIO.

Note

If running in a Windows machine, a common error is the incorrect carriage returns and symlinks not being created correctly when cloning your git repository. This can be fixed by doing the following:

  1. Run your editor in Administrator mode
  2. cd into your cloned git repository

View all of the configurations for your git repository in step 3. Duplicates may show up in this list because this command shows ALL git config (system, global, local). Any config defined at the local level will take precedent over config at the system or global level. If the below commands do not work, keep in mind that these are the values that core.autocrlf and core.symlinks need to have in order to work. (If you set git config --global core.symlinks true, and there is a local core.symlinks defined to false, the false will take precedent.)

  1. Run git config --list
  2. Run git config --global core.autocrlf false
  3. Run git config core.symlinks true
  4. Run git status
  5. Run git restore tools/gate/jarvis/100-deploy-k8s.sh
  6. Now proceed with the vagrant up command from the directory above

Note

For Vagrant to work, a virtualization provider (e.g. Virtualbox, libvirt) is required. The recommended provider in the Vagrantfile is Virtualbox, however, libvirt is included. To install Virtualbox, see the instruction at Virtualbox's page.

Note

This document does not cover the installation of vagrant. Please refer to the instructions at Vagrant's page.

Host Setup

To access the exposed Jarvis services in the Vagrant box, update the /etc/hosts file with:

192.168.56.10 gerrit.jarvis.local harbor-core.jarvis.local harbor-notary.jarvis.local loki.jarvis.local grafana.jarvis.local

Note

Replace jarvis.local with the appropriate host and domain name if those are overwritten.