| Pawel Wieczorek | 83040df | 2019-11-29 14:56:56 +0100 | [diff] [blame] | 1 | ===================================================== |
| 2 | ONAP Integration > Bootstrap > Vagrant Minimal ONAP |
| 3 | ===================================================== |
| 4 | |
| 5 | This directory contains a set of Vagrant scripts that will automatically set up: |
| 6 | |
| 7 | - Devstack, |
| 8 | - RKE-based Kubernetes cluster, |
| 9 | - Operator's machine with configured tools (kubectl, helm). |
| 10 | |
| 11 | This is intended to show a beginning ONAP operator how to set up and configure an environment that |
| 12 | can successfully deploy minimal ONAP instance from scratch. Its main purpose are ONAP demos and |
| 13 | proofs of concepts. It is not intended to be used as a production ONAP environment. |
| 14 | |
| 15 | NOTE: the Devstack instance is NOT SECURED, with default credentials: |
| 16 | |
| 17 | +-------+----------------+ |
| 18 | | User | Password | |
| 19 | +-------+----------------+ |
| 20 | | admin | default123456! | |
| 21 | +-------+----------------+ |
| 22 | | demo | default123456! | |
| 23 | +-------+----------------+ |
| Pawel Wieczorek | 8df0be5 | 2019-12-10 17:36:14 +0100 | [diff] [blame] | 24 | |
| 25 | |
| 26 | Requirements |
| 27 | ------------ |
| 28 | |
| 29 | +-------------+-----+-------+ |
| 30 | | Machine | CPU | RAM | |
| 31 | +-------------+-----+-------+ |
| 32 | | Operator | 1 | 1GiB | |
| 33 | +-------------+-----+-------+ |
| 34 | | Devstack | 2 | 6GiB | |
| 35 | +-------------+-----+-------+ |
| 36 | | K8s Control | 1 | 1GiB | |
| 37 | +-------------+-----+-------+ |
| 38 | | K8s Worker | 2 | 12GiB | |
| 39 | +-------------+-----+-------+ |
| 40 | | TOTAL | 6 | 20GiB | |
| 41 | +-------------+-----+-------+ |
| 42 | |
| 43 | Table above is based on current experience and may be subject to change. |
| 44 | |
| 45 | |
| 46 | Prerequisites |
| 47 | ------------- |
| 48 | |
| 49 | Virtualisation provider |
| 50 | ~~~~~~~~~~~~~~~~~~~~~~~ |
| 51 | |
| 52 | Environment has been tested using libvirt_ provider with vagrant-libvirt_ plugin. Plugin |
| 53 | documentation provides detailed `installation instructions`_ that will guide through the process. |
| 54 | |
| 55 | .. note:: |
| 56 | Remember to uncomment `deb-src` repositories for `apt-get build-dep` step on Debian/Ubuntu. |
| 57 | |
| 58 | .. _libvirt: https://libvirt.org |
| 59 | .. _vagrant-libvirt: https://github.com/vagrant-libvirt/vagrant-libvirt |
| 60 | .. _`installation instructions`: https://github.com/vagrant-libvirt/vagrant-libvirt#installation |
| 61 | |
| 62 | Virtual machine manager |
| 63 | ~~~~~~~~~~~~~~~~~~~~~~~ |
| 64 | |
| 65 | Environment has been tested using latest Vagrant_ as of writing this documentation (`v2.2.6`_). Some |
| 66 | features (e.g. triggers_) might not be supported on older versions. |
| 67 | |
| 68 | .. _Vagrant: https://www.vagrantup.com/downloads.html |
| 69 | .. _`v2.2.6`: https://github.com/hashicorp/vagrant/blob/v2.2.6/CHANGELOG.md#226-october-14-2019 |
| 70 | .. _triggers: https://www.vagrantup.com/docs/triggers/ |
| 71 | |
| 72 | |
| 73 | Running |
| 74 | ------- |
| 75 | |
| 76 | Additional `--provider` flag or setting `VAGRANT_DEFAULT_PROVIDER` environmental variable might be |
| 77 | useful in case there are multiple providers available. |
| 78 | |
| 79 | .. note:: |
| 80 | Following command should be executed within the directory where `Vagrantfile` is stored |
| 81 | (`integration/bootstrap/vagrant-minimal-onap`). |
| 82 | |
| 83 | .. code-block:: sh |
| 84 | vagrant up --provider=libvirt |