301 Commits

Author SHA1 Message Date
Ghanshyam Mann
208c46e72c [ussuri][goal] More cleanup for python 2.7 drop
Cleanup requirement and set ignore_basepython_conflict = True
in tox to avoid python version conflict warning which going
to be error in future.

Change-Id: Ia4ce42a20417d69efd50ef563aabd8cffbb7b346
2020-02-29 15:23:18 -06:00
Michal Nasiadka
a0ab81d752 Allow setting pip_proxy
Change-Id: I2547ef2556ca96b614854515069aaca3349cd692
2020-02-26 11:10:01 +01:00
Zuul
cc219bc0b5 Merge "[ussuri][goal] Drop python 2.7 support and testing" 2020-02-11 19:56:10 +00:00
Julia Kreger
baadf62635 [docs] Change CoreOS URLs to Centos URLs fir IPA
The ironic-python-agent coreos images are unsupported and are
anticipated to be removed from the tarballs.openstack.org site.

In advance of this, we need to remove references to these images.

Change-Id: Ifb402418d7962cf507b190e028a59b94ad5d46ac
2020-02-11 16:05:57 +00:00
chenxing
b41311f128 Docs: show other versions
Change-Id: I9bc19aa9dcea6dad242d93cecfb4f201ae855463
2020-02-11 19:23:39 +08:00
Ghanshyam Mann
c0a1216afa [ussuri][goal] Drop python 2.7 support and testing
OpenStack is dropping the py2.7 support in ussuri cycle.

kayobe is ready with python 3 and ok to drop the
python 2.7 support.

Complete discussion & schedule can be found in
- http://lists.openstack.org/pipermail/openstack-discuss/2019-October/010142.html
- https://etherpad.openstack.org/p/drop-python2-support

Ussuri Communtiy-wide goal:
https://governance.openstack.org/tc/goals/selected/ussuri/drop-py27.html

Change-Id: Idbbdd96ff23846d29833c5997d1e32e65b5169f2
2020-02-11 10:12:39 +00:00
Andreas Jaeger
d5a3c74b16 Update docs building
* Use storyboard instead of launchpad since this project uses
  storyboard. This fixes the "Report a bug" link.
* Remove unneeded configuration bits for doc building, the
  defaults of openstackdocstheme are fine.

Change-Id: Id7513b245d1b4eac09f717a7f47469fd7bb4d3b5
2020-01-30 09:40:39 +01:00
Zuul
47aeacbacb Merge "Add Nova Cells documentation" 2019-12-20 13:43:14 +00:00
Zuul
e65ac9ac08 Merge "Support custom Kolla group_vars" 2019-12-20 11:37:29 +00:00
Doug Szumski
aee2af7a75 Add Nova Cells documentation
Clearly not very user friendly at the moment. We probably want to
include these files as part of test.

Change-Id: Ib6ed0e68b55a98920cbaf3e8ec828901b4b9ed9f
Story: 2004291
Task: 37810
2019-12-18 18:34:34 +01:00
Doug Szumski
72d4d64609 Support custom Kolla group_vars
In Kayobe hosts which are part of a Nova cell can be managed via the
existing controller and compute groups. However, since Nova Cells are
configured via group vars in Kolla Ansible we need some way of setting
these. We could pass vars through to Kolla Ansible host vars using
`kolla_overcloud_inventory_pass_through_host_vars` but the list of
variables which may be set on a per cell basis is large and undefined.

This change allows the user to directly specify Kolla Ansible group vars
as part of Kayobe config, allowing the deployment of Nova Cells by
Kayobe to be largely unchanged from the procedure documented in Kolla
Ansible.

Change-Id: I2695034d36936fcc77a4828c67f9552155781dd6
Story: 2004291
Task: 37804
2019-12-18 16:45:36 +01:00
Zuul
01f04e500d Merge "Improve detection of base path" 2019-12-13 15:01:35 +00:00
Zuul
30e9c3af8a Merge "Use mariabackup for database backups" 2019-12-12 13:07:45 +00:00
Mark Goddard
e93bbd9ed5 Use mariabackup for database backups
Kolla ansible switched its database backup support to mariabackup from
xtrabackup due to incompatibilities. See
https://bugs.launchpad.net/kolla/+bug/1843043 for details.

Change-Id: Ib95771f09fd6d5e71a2af471de47f811e1cab88b
Related-Bug: #1843043
Story: 2006952
Task: 37634
2019-12-11 17:16:59 +00:00
Mark Goddard
c8f105a907 Support internal API TLS encryption
Kolla Ansible Train introduces support for TLS encryption of the
internal API. This change introduces support for internal API encryption
in Kayobe.

The following new variables are introduced:

* kolla_enable_tls_internal
* kolla_internal_tls_cert
* kolla_internal_fqdn_cacert

Also only set kolla_*_fqdn_cacert in globals.yml if set.

Change-Id: If432afde374fe247d09c952e110c9567e17daea1
Story: 2006959
Task: 37649
2019-12-11 17:13:38 +00:00
Pierre Riteau
5d6de8fc8b Add example to Bridges and VLANs section
Change-Id: I45c64dfe6a28f73b3c4f7ac4444e49b8488e55f7
2019-12-10 15:44:09 +00:00
Mark Goddard
8b80e8f2c5 Improve docs on kolla-ansible
Change-Id: Iff5788914c111944f1b4d74362c0f86428ebebe8
Story: 2004337
Task: 28504
2019-12-09 16:14:19 +00:00
Zuul
78de8c1dd8 Merge "Add command to deploy only containers" 2019-12-09 11:21:38 +00:00
Zuul
3bd981508a Merge "Use versioned links to OpenStack documentation" 2019-12-09 11:14:02 +00:00
Zuul
27138f3a2f Merge "Support installing packages in IPA images" 2019-12-06 18:04:36 +00:00
Zuul
7575bcf501 Merge "Add cross references from deployment to config docs" 2019-12-06 18:04:31 +00:00
Zuul
70f1a95363 Merge "Add documentation for Bifrost and IPA configuration" 2019-12-06 18:04:23 +00:00
Will Szumski
bf760189f2 Improve detection of base path
On Ubuntu sys.prefix is set to '/usr' even though pip will install
packages to '/usr/local' when not using a virtualenv. This change fixes
the detection in this instance. Non standard install locations are not
currently supported.

Change-Id: I214e11e7d099d1b39041fdc6b91002e1929d9c00
Story: 2005510
Task: 30620
2019-12-06 13:47:01 +00:00
Zuul
ce18bd2e68 Merge "tox: Keeping going with docs" 2019-11-28 17:20:42 +00:00
Mark Goddard
ca19d786c6 Add cross references from deployment to config docs
Hopefully this provides access to relevant information without breaking
the flow.

Change-Id: I40b71cdf782dda6971dafb5894670c30e446ccb0
Story: 2004337
Task: 37387
2019-11-28 16:46:55 +00:00
Mark Goddard
6b4f180a1e Support installing packages in IPA images
Diskimage builder supports specifying a list of packages to install via
-p. We currently support this for the root image, but not IPA images.

This change adds a new configuration option, 'ipa_build_dib_packages',
that should be a list of additional packages to install in locally built
IPA images. This affects the following commands:

kayobe seed deployment image build
kayobe overcloud deployment image build

This depends on
https://github.com/stackhpc/ansible-role-os-images/pull/25.

Also adds an example to the documentation for the equivalent option for
root image.

Change-Id: I04191d9541894b6a264e966c9ecb1056e0edade4
Story: 2006855
Task: 37446
2019-11-28 16:32:30 +00:00
Mark Goddard
66cb51a8bf Add command to deploy only containers
Kolla ansible train adds a new command, kolla-ansible deploy-containers,
that will only deploy containers, and skips registration, bootstrapping
and configuration.

This change adds a new 'kayobe overcloud service deploy containers'
command to make use of the new kolla-ansible command.

Change-Id: I999dfe4b1d082bc88148f54b236644abcbd96a5a
Story: 2006951
Task: 37633
2019-11-28 13:31:21 +00:00
Zuul
a30cf063d1 Merge "Document requirements for BIOS and RAID configuration" 2019-11-25 14:17:05 +00:00
Zuul
e1d4774fdc Merge "Improve docs on updating the Ansible control host" 2019-11-25 14:17:01 +00:00
Mark Goddard
3c7a6ef6a3 Document requirements for BIOS and RAID configuration
Ideally we will fix these issues, but documenting them is a good first
step.

Change-Id: I9a840005d62b974f0681ac39e1ff02ae3ff0120e
Story: 2004967
Task: 29410
2019-11-25 13:57:43 +00:00
Mark Goddard
410466bb5c Improve docs on updating the Ansible control host
Also reorder upgrade documentation to make it clear that configuration
migration is something that should be done as a preparatory task.

Change-Id: I97ada3c6fd94a9ab7b5add97e90717f2a56bc8f3
Story: 2006677
Task: 36953
2019-11-25 13:57:23 +00:00
Mark Goddard
8c01771e29 Add documentation for Bifrost and IPA configuration
Depends-On: https://review.opendev.org/690559/

Change-Id: I4e766424607317e5817d26461f7a1e180e9b2146
Story: 2004337
Task: 37378
Task: 37381
2019-11-25 13:42:21 +00:00
Zuul
b6caf483e8 Merge "Add note to docs about overcloud node names being required" 2019-11-19 13:08:20 +00:00
Mark Goddard
25ea46debc Add note to docs about overcloud node names being required
If the kayobe overcloud provision command is executed with overcloud
ironic nodes without names, cloud-init will fail with the following
Traceback when the deployed image boots:

Traceback (most recent call last):
  File "/usr/lib/python2.7/site-packages/cloudinit/sources/__init__.py", line 447, in find_source
    if s.get_data():
  File "/usr/lib/python2.7/site-packages/cloudinit/sources/__init__.py", line 132, in get_data
    self._get_standardized_metadata())
  File "/usr/lib/python2.7/site-packages/cloudinit/sources/__init__.py", line 110, in _get_standardized_metadata
    'local-hostname': self.get_hostname(),
  File "/usr/lib/python2.7/site-packages/cloudinit/sources/__init__.py", line 317, in get_hostname
    if util.is_ipv4(lhost):
  File "/usr/lib/python2.7/site-packages/cloudinit/util.py", line 544, in is_ipv4
    toks = instr.split('.')

This is a bug [1] in cloud-init. The symptom is that hosts provision
successfully, but are not accessible via SSH. A solution is to ensure
that all nodes are named.

Until we have a release of CentOS with the cloud-init fix included, we
should at least mention this limitation in our documentation.

[1] https://bugs.launchpad.net/cloud-init/+bug/1852100

Change-Id: If54f56fb9f0b626d9fae80db622b0feeae5464b9
Story: 2006832
Task: 37405
2019-11-19 13:51:38 +01:00
Zuul
27fa6b10af Merge "Add reference to zero touch provisioning blog in docs" 2019-11-14 15:31:59 +00:00
Zuul
483ad8f1c5 Merge "Fix customised inventory section" 2019-11-14 11:49:42 +00:00
Michal Nasiadka
ed8e1a63da Fix customised inventory section
Add a note to base customised inventory on a kayobe kolla-ansible
inventory template.

Change-Id: I75ace6878d36cb523c38a33daa9eecd62826fe43
2019-11-14 10:15:57 +00:00
Zuul
5820064ee6 Merge "Remove some references to Github" 2019-11-14 10:12:09 +00:00
Mark Goddard
8c1f3af579 Use versioned links to OpenStack documentation
The :project-doc: format is part of the openstackdocstheme, and allows
us to link to the same release of the documentation for other projects,
without having to keep our links in sync.

Change-Id: Ifff2fd2d4e3680a9a757d77928acf84b7e5a3dd7
2019-11-11 14:26:58 +00:00
gujin
d23ed92588 tox: Keeping going with docs
1. Sphinx 1.8 introduced [1] the '--keep-going' argument which, as its name
suggests, keeps the build running when it encounters non-fatal errors.
This is exceptionally useful in avoiding a continuous edit-build loop
when undertaking large doc reworks where multiple errors may be
introduced.

2. Cleanup the folders before run commands

[1] https://github.com/sphinx-doc/sphinx/commit/e3483e9b045

Change-Id: Ib3133820a3d3ca3027ea2f9bc9b6907929cff8ed
2019-11-11 13:49:54 +00:00
Mark Goddard
5408bb5453 Add reference to zero touch provisioning blog in docs
While not proper documentation, this should help people follow the ZTP
model.

Change-Id: If84a472826110bce151109ce80e70e1cef2a8177
Story: 2006640
Task: 37389
2019-11-11 10:16:31 +00:00
Mark Goddard
ee98efa8f0 Remove some references to Github
Change-Id: I358585260cc85fb1d364d2e246656557a2398ef9
2019-10-31 17:17:35 +00:00
Zuul
3c98bfa5b2 Merge "Add ansible tag headers to Host Configuration doc page" 2019-10-25 16:57:59 +00:00
Zuul
1d82724875 Merge "Add source code orientation to development docs" 2019-10-25 13:28:51 +00:00
Mark Goddard
798b7dfc53 Build pdf doc
The is one of community goals that each project should produce a
single PDF file. The pdf should be in the output of openstack-tox-docs
job.

TeX packages are required to build PDF locally, following is
recommended:

* inkscape
* texlive-latex-base
* texlive-latex-extra
* texlive-fonts-recommended

More about the goal:
https://governance.openstack.org/tc/goals/train/pdf-doc-generation.html
https://etherpad.openstack.org/p/train-pdf-support-goal
https://etherpad.openstack.org/p/pdf-goal-train-common-problems

Change-Id: Ib8a238f5ad4329527147be72331b87f57877f68e
2019-10-16 14:36:13 +01:00
Will Szumski
a3d3649c5e Install libffi headers
This is to resolve the following issue in CI:

    c/_cffi_backend.c:15:17: fatal error: ffi.h: No such file or directory
     #include <ffi.h>
                     ^
    compilation terminated.
    error: command 'gcc' failed with exit status 1
    ----------------------------------------
ERROR: Command errored out with exit status 1: /home/zuul/kayobe-venv/bin/python -u -c 'import sys, setuptools, tokenize; sys.argv[0] = '"'"'/tmp/pip-install-PV3WhJ/cffi/setup.py'"'"'; __file__='"'"'/tmp/pip-install-PV3WhJ/cffi/setup.py'"'"';f=getattr(tokenize, '"'"'open'"'"', open)(__file__);code=f.read().replace('"'"'\r\n'"'"', '"'"'\n'"'"');f.close();exec(compile(code, __file__, '"'"'exec'"'"'))' install --record /tmp/pip-record-ZvlZVY/install-record.txt --single-version-externally-managed --compile --install-headers /home/zuul/kayobe-venv/include/site/python2.7/cffi Check the logs for full command output.

Change-Id: I1bd724be7dc77058870f37cb1c9404472fa466ca
see: https://zuul.opendev.org/t/openstack/build/c20a316a699b4073abf75960634ebfcd
2019-10-15 13:35:15 +01:00
Isaac Prior
ee72de447c Add ansible tag headers to Host Configuration doc page
Change-Id: I3caa80da7c44704a3b6559d98f928d95e83289e5
Story: #2006212
Task: #35802
2019-10-09 09:33:26 +01:00
pengyuesheng
c620dd84f7 Blacklist sphinx 2.1.0 (autodoc bug)
See https://github.com/sphinx-doc/sphinx/issues/6440 for upstream details

Change-Id: Ia2c3c6f3d38474465fc012bc4b798a5da0d3aadb
2019-10-09 16:25:25 +08:00
Mark Goddard
7321205c06 Update docs after repo rename x/ to openstack/
Depends-On: https://review.opendev.org/669298
Change-Id: Ia4138179132d3a284b0c4bcc882b87bde22c9cc4
2019-09-16 17:39:29 +01:00
Mark Goddard
1a6326ae4b Fix typo in docs
TrivialFix

Change-Id: I8b1c469de8ae0a4c78accccfdfcb7b7552b05081
2019-09-11 15:34:17 +01:00