User Tools

Site Tools


joid:get_started

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
joid:get_started [2015/11/21 03:40]
Artur Tyloch
joid:get_started [2016/01/13 18:00] (current)
Iben Rodriguez adding jenkins job naming convention
Line 1: Line 1:
-======  ​Integrate you lab with Joid ======+======  ​Deploy JOID in your POD ======
  
 (Help us to improve this page) (Help us to improve this page)
Line 13: Line 13:
  
 ''​git clone https://​gerrit.opnfv.org/​gerrit/​p/​joid.git''​ ''​git clone https://​gerrit.opnfv.org/​gerrit/​p/​joid.git''​
 +
 ''​cd joid/​ci''​ ''​cd joid/​ci''​
 +
 +===== Automate JOID setup with Jenkins =====
 +  * Setup your jumphost
 +  * Setup Jenkins Slave for your lab https://​wiki.opnfv.org/​octopus/​jenkins_slave_connection
 +  * Setup create JJB Jenkins Job Builder Script for your pod in your lab
 +  * Test and iterate JJB script to deploy MaaS and Juju VMs on Jumphost to complete JOID Setup
 +
 +==== Jenkins Job Naming Convention ==== 
 +
 + - Based on scenario naming we can get joid options naming convention:
 +     ​os-<​controller>​-<​nfvfeature>​-<​mode>​[-<​extrastuff>​]
 + - With parameters:
 +     ​controller=(nosdn|odl_l3|odl_l2|onos|ocl)
 +        No odl_l3 today
 +     ​nfvfeature=(kvm|ovs|dpdk|nofeature)
 +        '​_'​ list separated.
 +     ​mode=(ha|noha)
 +     ​extrastuff=(none)
 +        Optional field - Not used today
 + 
 +Actual scenario list:
 +
 +  - '​os-nosdn-nofeature-noha':​
 +    - auto-trigger-name:​ '​brahmaputra-trigger-daily-disabled'​
 +  - '​os-nosdn-nofeature-ha':​
 +    - auto-trigger-name:​ '​brahmaputra-trigger-daily-disabled'​
 +  - '​os-odl_l2-nofeature-ha':​
 +    - auto-trigger-name:​ '​joid-{scenario}-{pod}-trigger'​
 +  - '​os-odl_l2-nofeature-noha':​
 +    - auto-trigger-name:​ '​brahmaputra-trigger-daily-disabled'​
 +  - '​os-onos-nofeature-ha':​
 +    - auto-trigger-name:​ '​brahmaputra-trigger-daily-disabled'​
 +  - '​os-onos-nofeature-noha':​
 +    - auto-trigger-name:​ '​brahmaputra-trigger-daily-disabled'​
 +
  
 =====   ​Enable MAAS ===== =====   ​Enable MAAS =====
Line 26: Line 62:
 deployment.yaml ​ environments.yaml ​ interfaces.host ​ lxc-add-more-interfaces deployment.yaml ​ environments.yaml ​ interfaces.host ​ lxc-add-more-interfaces
  
-==== modify ​deployment.yaml file ====+==== deployment.yaml file ====
  
-This file has been used to configure your maas and bootstrap node in a VM. Comments in the file are self explanatory and we expect fill up the information according to match lab infrastructure information.+=== Prerequisite:​ ===
  
-====   ​modify interfaces.host file ====+  ​- Make sure Jump host node has been configured with bridges on each interface. So that appropriate MAAS and JUJU bootstrap VM can be created. For example if you have three network admin, data and public then I would suggest to give names like brAdm, brData and brPublic. 
 +  - You have information about the node MAC address and power management details (IPMI IP, username, password) of the nodes used for control and compute node.
  
-This file will be used to configure your network interfaces on the rest of the nodes deployed through MAAS. 
-I would suggest to list interface you want to bring up after the deployment of the Operating System. JUJU will do that using this file. 
  
-==== modify lxc-add-more-interfaces file ====+==== modify ​==== 
 + 
 +This file has been used to configure your maas and bootstrap node in a VM. Comments in the file are self explanatory and we expect fill up the information according to match lab infrastructure information. Sample deployment.yaml can be found at [[https://​gerrit.opnfv.org/​gerrit/​gitweb?​p=joid.git;​a=blob;​f=ci/​maas/​intel/​pod5/​deployment.yaml]]  
 +====   ​interfaces.host file ==== 
 + 
 +This file will be used to configure your network interfaces on compute and control nodes deployed through MAAS. 
 + 
 +I would suggest to list interface (brData, brPublic) you want to bring up after the deployment of the Operating System on bare metal. JUJU will implement the same using the charm attached to the JOID. 
 + 
 +==== lxc-add-more-interfaces file ====
    
-This File will be used as network template to create the network in containers.\+This File will be used as network template to create the network ​(eth1 and eth2 for data and Public) ​in containers.
  
 ===== MAAS Deployment ===== ===== MAAS Deployment =====
Line 62: Line 106:
 This section will guide you how to configure joid to your environment to deploy OPNFV platform. This section will guide you how to configure joid to your environment to deploy OPNFV platform.
   * Make sure you have environments.yaml in ~/joid/ci directory. If it does not exist then most likely you have not used the above method to deploy MAAS. In that case please copy the file manually.   * Make sure you have environments.yaml in ~/joid/ci directory. If it does not exist then most likely you have not used the above method to deploy MAAS. In that case please copy the file manually.
-  * make sure all changes ​in bundle file ./​odl/​juju-deployer/​ovs-odl-ha.yaml ​has the correct information. If no then i would request you to modify the ~/​joid/​ci/​01-deploybundle.sh ​file to modify fot your lab.+  * verify the info in all 3x4 = 12 yaml configuration files (for example): 
 +  * ~/joid/ci/​odl/​juju-deployer/​ovs-odl-ha.yaml 
 +  * modify the deploy bundle shell script for each of the 4 network controllers to add your lab: 
 +  * ~/joid/ci/nosdn/​01-deploybundle.sh 
 +  * ~/​joid/​ci/​odl/​01-deploybundle.sh 
 +  * ~/​joid/​ci/​onos/​01-deploybundle.sh 
 +  * ~/​joid/​ci/​opencontrail/​01-deploybundle.sh
  
   '' ​   '' ​
Line 78: Line 128:
   ''​   ''​
 ===== Run the deployment using JOID ===== ===== Run the deployment using JOID =====
-Once you have modified the above sections then deploymeny ​will be very easy. Please do the following:+When the machines in the lab are ready to be powered on and booted we can continue. 
 + 
 +Once you have modified the above sections then deployment ​will be very easy. Please do the following: 
 + 
 +''​ ./deploy.sh -o liberty -s odl -t nonha -l intelpod7 ''​ 
 + 
 +Above statement will deploy the openstack kilo with sdn odl in HA mode in Intel lab pod7 
 + 
 +If you wants to deploy the opencontrail then you need to replace the odl with opencontrail and liberty with juno in the above command. 
 + 
 +===== Submitting merge proposal to joid ===== 
 +On successful deployment test please submit the merge proposal into joid using git. 
 + 
 +Please follow https://​wiki.opnfv.org/​developer/​getting_started for any developer tools.  
 + 
 +''​ git add --all ''​
  
-'' ​./deploy.sh -o kilo -s odl -t ha -l intelpod7 ​''​+'' ​git commit ​''​
  
-Above statement will deploy the openstack kilo with sdn odl in HA mode in intel lab pod7+''​ git review -D ''​
  
-If you wants to deploy the opencontrail then you need to replace the odl with opencontrail in the above command.+Few above commands will be useful ​to submit your patch for review.
  
joid/get_started.1448077206.txt.gz · Last modified: 2015/11/21 03:40 by Artur Tyloch