Commit Graph

64 Commits

Author SHA1 Message Date
Ghanshyam Mann 8325044e7a Retire Tripleo: remove repo content
TripleO project is retiring
- https://review.opendev.org/c/openstack/governance/+/905145

this commit remove the content of this project repo

Change-Id: Ib988f3b567e31c2b9402f41e5dd222b7fc006756
2024-02-24 11:41:49 -08:00
Harald Jensås d01331db06
Fix PEP8 and docs
PEP8 allowlist_externals + yaml dependency

* whitelist_externals is deprecated.
* PyYAML required for successfull environment generator run.

Add entries requirements for doc.

Change-Id: I920d245a76aeb762fb1ad9317d42156de028104f
2023-09-11 12:39:02 +02:00
Steve Baker ce863ae11c Make ipxe-boot image EFI capable
This refreshes the ipxe build makefile to build an image
that works in both legacy BIOS and UEFI environments.

This makes the following changes:
- Moves the ipxe submodule commit to current master
- Creates an EFI partition efi.img containing ipxe.efi
  as the default binary
- Builds ipxe-boot.img as an MBR/GPT hybrid ISO which boots
  and runs iPXE in both legacy BIOS and UEFI environments
- Stop creating ipxe-boot.qcow2 since the conversion from
  ipxe-boot.img has an incorrect EFI partition, and there is
  no real benefit over the raw image anyway
- Refresh the documentation for how to upload the images to
  an OpenStack cloud, remove the redundancy from ipxe/README

Change-Id: I720ed5aaa0d55ded73e01aaba9db66602adc26cd
2022-03-30 15:16:39 +13:00
Hervé Beraud fa7e59644d Add doc/requirements
We need to specify doc requirements in doc/requirements.txt
to avoid problems with the pip resolver [1] for the release team [2][3].
Removing specific doc requirements from test-requirements.txt.

The problem here is that this repos haven't doc/requirements.txt file
and by default in this case zuul will use the test-requirements.txt file
to pull requirements [4].

This requirements file contains extra requirements like flake8 that
collided with those allowed in our job environment and so the new pip
resolver fails to install these requirements and the job exits in error.

This project meet the conditions leading to the bug however it doesn't
produce any doc or releasenotes, but uniformization can't hurt and help
us in the future.

[1] http://lists.openstack.org/pipermail/release-job-failures/2021-January/001500.html
[2] http://lists.openstack.org/pipermail/openstack-discuss/2021-January/019611.html
[3] http://lists.openstack.org/pipermail/openstack-discuss/2021-January/019612.html
[4] https://opendev.org/zuul/zuul-jobs/src/branch/master/roles/ensure-sphinx/tasks/main.yaml#L36

Change-Id: I746d4b743924eefeb606e8516e2f60244b977c92
2021-01-07 16:07:40 +01:00
Harald Jensås 135786a9ca Add IPv6 radvd and dhcpv6 relay support
Add a new templates to configure radvd and dhcpv6 relay.

For IPv6 routed network the radvd daemon and the dhcpv6
relay is hosted on the same instance.

Since we do not want the networks in the OVB infra to
provide any DHCP or auto configuration we cannot use
neutron routers for provisioning network routing. The
instance running dhcpv6 relay and radvd will also be
the router for the provisioning networks.

Bump template version in undercloud-networks-routed.yaml
to version 2015-10-15. Need this version to avoid error:
  'Items to join must be strings not
   {u'str_split': [u'/', u'fd12:3456:789a:3::/64', 1]}'

Change-Id: Ib95f7d7cfd3d2318ac4f4f44f22955b0c18c465e
2020-05-12 13:40:44 +02:00
Harald Jensås 24e7a37b7e Add radvd helper instance for ipv6 provisioning
Deploy an instance running radvd providing router
advertisement for the provisioning network.

Depends-On: https://review.rdoproject.org/r/25787
Change-Id: Ife0cbedb69001d8473141c93c1d5163694f855a5
2020-03-10 22:57:33 +00:00
Matthew Booth e87628318a Remove pre-built iPXE image from the repo
Change-Id: If48823aceb2d61319ef08d72a21c7449618e8c47
2019-09-26 12:38:06 +01:00
Zuul 7966bfa15e Merge "Make BMC optional" 2019-03-27 21:45:42 +00:00
Ben Nemec 4275494d34 Fix formatting of host cloud patch note
The single : caused this to be treated as a comment and not visible
in the rendered output.

Change-Id: Ib9164d6479079786e28a40d1e6ffe5119962dfc4
2019-03-26 15:29:56 -05:00
Ben Nemec 6210189b04 Make BMC optional
When using pre-deployed servers, you may want all of the networking
setup of OVB but don't actually need to control the instances via
IPMI. While this could already be done, it left a useless BMC
instance lying around. This change allows the BMC to be disabled
completely to clean up such environments.

Change-Id: Icd6936977684d178277ebb721a7fbb3ffad51d9a
2019-03-21 12:56:31 -05:00
Ben Nemec 5a3e5e876f Add note about patching the host cloud
This hasn't been a mandatory part of the host cloud setup for a while
now, and we should note that in the documentation.

Change-Id: I63b52270a740ae92eac0fa390179c44b3a2a41cd
2019-03-20 16:55:28 -05:00
Ben Nemec 3797a18965 Add base-extra-node-all sample environment
This is the same as base-extra-node, except that it uses the port
template which opens all ports on all networks.

Change-Id: I14fd83e6ef69df0493656bf59ad8ccfeaa932b02
2019-02-12 16:57:57 -06:00
Ben Nemec cd32029388 Stop using setup.py [test|testr|build_sphinx]
These are all deprecated. For unit testing stestr should be used
directly, and for doc builds sphinx-build should be used directly.

A couple of minor doc changes were needed to eliminate warnings.

Change-Id: Ic2e1b9d692c9b5866f888fb4c8c08bf95742764e
2019-01-16 13:21:28 -06:00
Sorin Sbarnea 9a151e9b10 Fix ovb cloning location
Project was moved under openstack.

Change-Id: I666693dd2fb3517d53064c9b309c6760a5d79feb
2019-01-16 17:28:08 +00:00
Ben Nemec 247c2d02d2 Remove non-port-security templates
OVB 2.0 won't support clouds that lack the port-security extension,
so these are no longer needed.
2018-12-12 22:31:13 +00:00
Ben Nemec 870a848349 Add environment to enable public router
Since the router for the public network is disabled by default, we
should have an enablement environment so people don't have to
manually add it to their env file.
2018-10-31 20:47:43 +00:00
Ben Nemec e4edf35b64 Split routed-networks environment
This allows the path-specific registry entries to be static and
doesn't impose any requirements on where the environment containing
parameters lives. The documentation is also updated, which required
a newer version of sphinx to allow automatic references to headings.
2018-10-31 20:38:04 +00:00
Harald Jensås 4b74d2e1e9 Doc - copy and edit sample environments
Instead of referencing same environment files directly,
change the doc to copy the sample files and edit them.
2018-10-18 14:07:38 +02:00
Harald Jensås a16f379e1b Use 192.168.x.x addressing instead of 192.0.x.x addressing
192.0.x.x is non-private addresses. Since we now in some
cases care about the address ranges used in the environment
switch to use addresses in the private space 192.168.x.x.

Also minor update to doc, router addresses are no longer
dynamically allocated.
2018-10-18 11:46:16 +02:00
Harald Jensås 9b95965945 Fix more typos in docs 2018-10-17 14:13:06 +02:00
Harald Jensås 8de7f81dd1 Update routed-networks docs
Reference sample environments in environment index.
Update the deploy command to use the default env files.

Add Note regarding TripleO Undercloud physical network
name of ``local_subnet``.

Fixes some typos.
2018-10-17 13:26:33 +02:00
Harald Jensås 4d48192957 Doc - Quintupleo routed networks
Add a chapter in the quintupleo section of the documentation
with steps to deploy a TripleO development environment with
routed networks.
2018-10-12 19:58:14 +02:00
Ben Nemec ef30ff2e56 Add sample environments for routed networks
Also fixes a problem with the base environment that was preventing
the env-generator from functioning with the new template layout.
2018-10-05 16:42:46 +00:00
Ben Nemec 405cf53ed1 Update introduction to reflect current status
It's no longer true that OVB can't run on public clouds. This change
updates the introduction to better describe the current situation
with OVB on public cloud, and to make note of another limitation
that recently came to my attention.
2018-09-07 11:38:38 -05:00
Ihar Hrachyshka 79788ab96a Use xlarge flavor for undercloud nodes
Minimal requirements for undercloud nodes are described here:
https://images.rdoproject.org/docs/baremetal/requirements.html

Specifically, it says:

"The undercloud VM or baremetal machine requires: [...] 16 GB free
memory"

It's not just documentation that asks to change default flavor. If you
try to deploy using tripleo-quickstart in RDO cloud / OVB, you will hit
both tripleo-validations failures like:

There are 4 cores in the system, but there should be at least 8.
The RAM on the undercloud node is 7822 MB, the minimal recommended value
is 16384 MB.

And even when validations are ignored, the resulting environment fails
because mariadb (or another crucial service) is killed by oom-killer. I
personally experienced mariadb killed and as a result, heat-api
failing when listing stacks with ECONNREFUSED from db server, which
finally resulted in overcloud deployment failure.

xlarge is the smallest default flavor that provides 16gb ram, and so
this patch uses this flavor.
2018-01-24 13:13:51 -08:00
Ben Nemec 9908855a08 Make quintupleo deploy command more realistic
In practice, very few users deploy an OVB environment anymore with
no additional environments.  This change adds a few common ones to
the example command.  While these environments won't all work on
older clouds and may not be necessary in some circumstances, in
most cases they won't hurt anything and make it more likely that
a user's first attempt to deploy will succeed.

In addition, by explicitly passing env.yaml in the example, if users
do add more environment files they won't have to remember to also
add env.yaml.  This would be an easy mistake to make that might
result in confusing failures.
2018-01-24 14:32:16 -06:00
Ben Nemec f001b76e08 Add docs about deleting an OVB environment
Previously it was assumed that the user would know to delete the
Heat stack to delete an environment.  Since that's not actually
obvious to a new user, add explicit documentation of it.
2018-01-24 10:31:52 -06:00
Ben Nemec 4f2ae35882 Add more granular boot-from-volume envs
There may be situations where it is useful to boot only the
undercloud or only the baremetal nodes from volume.  This commit
adds environment files to enable that.
2018-01-22 14:39:16 -06:00
Ben Nemec b253011731 Write split node files for extra roles
There are multiple use cases for tracking the nodes of a given role
using a separate JSON file.  This change adds output files for each
role individually, in addition to the standard nodes.json that
includes everything in the deployment.  If no roles are being used,
the behavior is the same as before.
2017-09-20 13:44:17 -05:00
Ben Nemec c288a1ae97 Add ability to deploy extra undercloud node role
Adds a sample role environment that will deploy additional
undercloud-like nodes.  In order to do this, it is necessary to
allow override of the baremetal_image parameter in role files, so
that functionality is added too.
2017-09-19 15:36:26 -05:00
Ben Nemec d6b5e1ae7b Improve network documentation
The MTU docs were not in the usage section, which is problematic
since many users will not be doing the host cloud setup.  This
change also improves the documentation around deploying a network
isolation cloud in an OVB environment.
2017-08-18 16:46:07 -05:00
Ben Nemec 5c6d5b144b Add bmc_use_cache environment 2017-08-17 10:21:16 -05:00
Ben Nemec 4d55b7592d Add boot-from-volume support
In some clouds ephemeral storage is much slower than volume storage,
so we want to be able to use volume storage for the performance-
sensitive instances.  This change adds new environments to enable
that and updates build-nodes-json to handle the case where there is
no image associated with an instance.
2017-08-17 10:01:58 -05:00
Ben Nemec b394380ddc Add note about explicitly passing env.yaml
When multiple environments are in use, deploy.py will not add env.yaml
by default.  The docs need to make note of this so users aren't
surprised.
2017-08-09 12:20:28 -05:00
Ben Nemec 728b19c5b2 Document standalone option environments
Since we can't rely on comments in the sample env file anymore we
need formal documentation of the various options available.
2017-08-09 11:58:59 -05:00
Ben Nemec ad463c8bda Clarify the overcloud net_cidr parameter descriptions
These values are ignored in a typical OVB deployment so there is no
need to change them.  Let users know that since we are exposing the
parameters in the sample environments.
2017-08-09 10:09:06 -05:00
Ben Nemec a0733893f6 Add index of all available sample environments
This should make it easier for users to see what options are
available for use.
2017-08-09 10:03:42 -05:00
Ben Nemec 5aa4bce35b Add new Nova patch file for Pike
The existing diff finally doesn't apply cleanly, so we need a new
one for Pike and up.
2017-06-08 15:38:57 -05:00
Ben Nemec f01cc0e10a Add note about rebuilding vms 2017-06-08 12:32:04 -05:00
Ben Nemec 186f708a79 Document turning off port-security for undercloud 2017-06-08 10:25:54 -05:00
Ben Nemec 347ac586b8 Recommend using quintupleo method
Deploying a QuintupleO environment is usually going to be much
easier than starting from a base baremetal environment and adding
all of the necessary bits.  This is particularly true when using
port-security to allow undercloud DHCP because then the user is
responsible for shutting off port-security on the undercloud port.
2017-06-08 10:25:45 -05:00
Ben Nemec cef60f6d34 Document creation of private network 2017-06-08 10:18:37 -05:00
Ben Nemec 1bef041283 Update undercloud MTU docs
Now that all current upstream releases support local_mtu, let's
use that for setting MTU.  It's much simpler.

The previous docs are left as-is in a note for anyone deploying
older releases.
2017-05-30 14:39:27 -05:00
Ben Nemec a8886e99d1 Document the auth module
Docstrings were not written for this module initially.  This
addresses that shortcoming.  The module is also added to the api
doc index so it will show in the documentation.
2017-04-27 12:39:40 -05:00
Ben Nemec f84b06c616 Re-word definition of host cloud
Specify that the host cloud must be running on real baremetal.  This
should sufficiently differentiate it from the nested clouds in a
virtual baremetal deployment.
2017-03-22 11:04:21 -05:00
Ben Nemec c39b4ea157 Bump baremetal flavor to 8 GB
This is what is being tested in tripleo-ci these days, so it's a
more sane default.  The size of the flavor can always be customized
as desired.
2017-02-28 16:51:32 -06:00
Ben Nemec 39a2fe6321 Strengthen --id recommendation for quintupleo
There are a lot of subtle things that break if name collisions
happen between two OVB envs.  --id should prevent all of them, so
it's a best practice to use it any time there are multiple envs.
2017-02-02 10:33:20 -06:00
Ben Nemec 4634a916b7 Move note about multiple stacks with role deployments
It's better to have this early so if an initial deployment fails,
the user has the necessary details about deleting the stack up
front.  Otherwise they had to get all the way to the end of the
doc.
2017-02-01 11:03:27 -06:00
Ben Nemec 26c56b1d24 Reformat troubleshooting docs
Now that we have a table of contents, let's format this doc so the
various sections show up as independent headings.
2017-01-16 12:25:57 -06:00
Ben Nemec 4379ac7d59 Add troubleshooting docs to sphinx docs
Just moving the pre-existing standalone troubleshooting doc to
the sphinx doc tree.
2017-01-16 12:16:33 -06:00