airship/charts
Code Issues Proposed changes

Merge "docs: Add Windows help with vagrant"

Browse Source
This commit is contained in:
Zuul 2021-02-18 23:54:52 +00:00 committed by Gerrit Code Review
commit ba6f30dabe
1 changed files with 23 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
doc/source/install/jarvis/vagrant.rst
View File

@ -20,6 +20,29 @@ 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.)
3. Run ``git config --list``
4. Run ``git config --global core.autocrlf false``
5. Run ``git config core.symlinks true``
6. Run ``git status``
7. Run ``git restore tools/gate/jarvis/100-deploy-k8s.sh``
8. 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