summaryrefslogtreecommitdiffstats
path: root/fuel/ci/README
blob: f99db994ac9a31e9b66ad2e0f57e186d8af34ec0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
##############################################################################
# Copyright (c) 2015 Ericsson AB and others.
# stefan.k.berg@ericsson.com
# jonas.bjurel@ericsson.com
# All rights reserved. This program and the accompanying materials
# are made available under the terms of the Apache License, Version 2.0
# which accompanies this distribution, and is available at
# http://www.apache.org/licenses/LICENSE-2.0
##############################################################################

The genesis/fuel/ci directory holds all Fuel@OPNFV abstractions for the OPNFV
community release and continous integration pipeline.
There are two Fuel@OPNF autonomous scripts fo this, complying to the OPNFV CI pipeline guideline:
 - build.sh
 - deploy.sh

For more info on usage:
./build.sh -h
sudo ./deploy.sh -h
python deploy.py -h

usage: python deploy.py [-h] [-nf] [-nh] [-fo] [-co] [-c] [-iso [ISO_FILE]]
                        [-dea [DEA_FILE]] [-dha [DHA_FILE]] [-s STORAGE_DIR]
                        [-b PXE_BRIDGE] [-p FUEL_PLUGINS_DIR]

optional arguments:
  -h, --help           show this help message and exit
  -nf                  Do not install Fuel Master (and Node VMs when using
                       libvirt)
  -nh                  Don't run health check after deployment
  -fo                  Install Fuel Master only (and Node VMs when using
                       libvirt)
  -co                  Cleanup VMs and Virtual Networks according to what is
                       defined in DHA
  -c                   Cleanup after deploy
  -iso [ISO_FILE]      ISO File [default: OPNFV.iso]
  -dea [DEA_FILE]      Deployment Environment Adapter: dea.yaml
  -dha [DHA_FILE]      Deployment Hardware Adapter: dha.yaml
  -s STORAGE_DIR       Storage Directory [default: images]
  -b PXE_BRIDGE        Linux Bridge for booting up the Fuel Master VM
                       [default: pxebr]
  -p FUEL_PLUGINS_DIR  Fuel Plugins directory



* EXAMPLES:

- Install Fuel Master and deploy OPNFV Cloud from scratch on Hardware Environment:

    sudo ./deploy.sh -iso ~/ISO/opnfv.iso -dea ~/CONF/hardware/dea.yaml -dha ~/CONF/hardware/dha.yaml -s /mnt/images -b pxebr -p ~/PLUGIN


- Install Fuel Master and deploy OPNFV Cloud from scratch on Virtual Environment:

    sudo ./deploy.sh -iso ~/ISO/opnfv.iso -dea ~/CONF/virtual/dea.yaml -dha ~/CONF/virtual/dha.yaml -s /mnt/images -p ~/PLUGIN


- Deploy OPNFV Cloud on an already active Environment where Fuel Master VM is running so no need to install Fuel again:

    sudo ./deploy.sh -nf -dea ~/CONF/virtual/dea.yaml -dha ~/CONF/virtual/dha.yaml

    => with plugin installation
    sudo ./deploy.sh -nf -dea ~/CONF/virtual/dea.yaml -dha ~/CONF/virtual/dha.yaml -p ~/PLUGIN

    => with cleanup after deployment is finished
    sudo ./deploy.sh -nf -dea ~/CONF/virtual/dea.yaml -dha ~/CONF/virtual/dha.yaml -p ~/PLUGIN -c

    => no healthcheck after deployment is completed
    sudo ./deploy.sh -nf -dea ~/CONF/virtual/dea.yaml -dha ~/CONF/virtual/dha.yaml -p ~/PLUGIN -nh


- Install Fuel Master only (and Node VMs when using virtual environment):

    => for virtual environment:
    sudo ./deploy.sh -iso ~/ISO/opnfv.iso -dea ~/CONF/virtual/dea.yaml -dha ~/CONF/virtual/dha.yaml -s /mnt/images

    => for hardware environment:
    sudo ./deploy.sh -iso ~/ISO/opnfv.iso -dea ~/CONF/hardware/dea.yaml -dha ~/CONF/hardware/dha.yaml -s /mnt/images -b pxebr


- Cleanup a running OPNFV environment:

    sudo ./deploy.sh -co -dha ~/CONF/virtual/dha.yaml