110 Commits

Author SHA1 Message Date
Zuul
7189ca7f1e Merge "Update docs & upgrade scripts for Stein" 2018-09-07 04:38:47 +00:00
Jonathan Rosser
a9d422151a Move bionic jobs to voting, add release note.
Bionic check jobs are now passing so move these to voting and
add gate/periodic jobs for bionic.

Introduce a release note detailing the major changes and indicating
a viable upgrade path from Xenial to Bionic.

Change-Id: I0897e4f22b3949ce07a2ea0f2ee9c4f45c344e04
2018-09-06 08:49:56 +00:00
Florian Haas
6e8904062f Update docs & upgrade scripts for Stein
Closes-Bug: #1790158
Change-Id: I37d8c90dedf0cf9e36c913ba7541440b9964e631
2018-09-04 17:20:29 +01:00
Zuul
59e795288c Merge "Set kernel logging to 'quiet' in AIOs" 2018-08-08 13:26:41 +00:00
Markos Chandras
2da59eeabc [docs] Add documentation for 'install_method' variable
The 'install_method' variable can be used to deploy OpenStack services
either from source or from distribution packages. Since this variable
is meant to be set during the initial deployment and can't be changed
afterwards, it is important to document it in order to let deployers
know about it.

Implements: blueprint openstack-distribution-packages
Change-Id: I59fe66a5cef45487afbfc090aca93cb567427f7a
2018-08-07 14:40:21 +00:00
Jean-Philippe Evrard
447049070a Set kernel logging to 'quiet' in AIOs
Currently the default CentOS value is to set printk to
7 4 1 7, showing up all the DEBUG messages.
OpenSUSE Leap 42.3 is using 1 4 1 7, while Ubuntu is
using 4 4 1 7.

This patch changes the default console_loglevel to 4 in AIOs
to only print KERN_WARNING, KERN_ERR, KERN_CRIT, and
KERN_ALERT, as this seems the best balance of reducing logging IO
while still exposing relevant errors in tests.

This patch also ensures users are aware that centos have a higher level
of kernel logging by default, so they can take their own decisions
about it.

Change-Id: I4ceb5b7d436b258656b0193dd5e2ef3efb44f592
2018-08-07 13:32:25 +00:00
Jean-Philippe Evrard
8913620375 Do not install linux-image-extra by default
In Ubuntu 14.04, the kernel shipped was lightweight, and some
extra features like using vhost_net, required the package
linux-image-extra.

In Ubuntu 16.04 and above, this is not the case anymore,
as many kernel packages ship with extra features.

vhost_net is generally shipped with the kernel package nowadays
and was the only one documented for the addition of the
linux-image-extra into our roles.

Change-Id: I70fa446c2dd00e12702280388299d189e0f3e5c4
Depends-On: https://review.openstack.org/#/c/585376/
Closes-Bug: 1783342
2018-07-24 14:46:01 +00:00
wangqi
40771a06c0 Replace deprecated library function os.popen() with subprocess
os.popen() is deprecated since version 2.6. Resolved with use of
subprocess module.

Change-Id: I895f12807b3823f649369f27495c9182f01a7a14
2018-05-17 13:44:15 +00:00
Zuul
9a1ef57dd7 Merge "Fix the appropriate kernel modules path" 2018-05-10 03:37:56 +00:00
Jean-Philippe Evrard
e44dc6666f [Docs] Fix links to figures
Targetting the wrong folder, and the files were
not in the right folder.

Closes-Bug: #1768554
Change-Id: I324ea0da95302612249c6119fa86e2b9c571bdfd
2018-05-09 18:50:48 +02:00
ZhijunWei
da956a0622 Fix the credentials file name
Change-Id: Ib4ae946720741741cd56a9ffab9aeb9fd2f0ec97
2018-04-29 12:06:23 +00:00
ZhijunWei
0aaeffec02 Fix the appropriate kernel modules path
Change-Id: I3567690df5f4c792d4b908978b17d0112e7a7f37
2018-04-29 11:43:04 +00:00
Jesse Pretorius
ca49f4121e Ensure that RDO/SUSE series repo instructions stay up to date
The deployment host documentation gets out of date really quickly.
This patch makes it self maintaining. Note that due to the fact
that RDO/SUSE do not implement their repositories for a new
release until much, much later in the cycle, we use the previous
release repo for master. This will self-update during our RC
when the stable branch is cut.

Some formatting adjustments have made to prevent the interpretation
of URL's as links by sphinx and to remove the use of multi-line shell
commands.

Closes-Bug: #1759721
Change-Id: Id28540d335390a52e0eb65a734a1d594235265d6
2018-04-04 10:56:24 +01:00
Zuul
cecf1f21ed Merge "[Docs] Simplify docs configuration" 2018-03-30 06:16:50 +00:00
Jean-Philippe Evrard
5a8e199ca1 [Docs] Simplify docs configuration
We don't need that many variables for the deployment guide, there
is barely any substitutions done. Simplify the documentation to
a bare minimum.

On top of this, we adapt for the latest openstackdocstheme.

Change-Id: I3502b6a943bacc6dac1b757961348eb04771750d
2018-03-29 19:12:45 +00:00
Zuul
d23b8d9f01 Merge "[Docs] Include OpenStack-Ansible Manifesto" 2018-03-24 23:34:35 +00:00
Jean-Philippe Evrard
d99c1d3469 [Docs] Include OpenStack-Ansible Manifesto
The OpenStack Ansible Deployment manifesto [1] was lost in times in
pages long forgotten of the wiki.

Instead, it should be part of the documentation, in our reference
section. The reference is a great place because it's where we
explain WHY we are doing things.

To increase visibility of this page, the design decisions are
directly linked from the deploy guide appendix about
"Why OpenStack-Ansible".

Change-Id: Ifb3ef041c773ee6dbe6606e2e5efc0542776dfc5
2018-03-23 19:15:48 +00:00
Jean-Philippe Evrard
62bbe0f38e [Docs] Adapt the wording for disk requirements
Disks requirements aren't clear, and people can think it's
always required to have 1TB disk on cinder nodes. There is no
hard requirement there, so we should remove this requirement,
mark it as recommendation, and point its only for LVM backends.

Change-Id: Ic45a7799e5092653d70fce9f2b6b7ae3f03d8775
2018-03-23 13:30:14 +00:00
Jean-Philippe Evrard
9be2fe792c [Docs] Uniform image on top
The workflow is on top of the pages, this is an exception. It
should fix it.

Change-Id: I40c9981f2c6b26fe5c2c61cfc45330cd476f2385
2018-03-23 12:23:49 +00:00
Jean-Philippe Evrard
c49b5efa66 [Docs] Change heading in target hosts
This brings consistency between target hosts configuration and
deploy host configuration, to be easier to read.

Change-Id: Ibaa01dfc6190f41ea0a3d1ca353296c3e8ec4f7f
2018-03-23 12:23:25 +00:00
Jean-Philippe Evrard
8bfc32399e [Docs] Simplify overview page
This modifies the overview section to be one page instead of
4 long sections. We just refer to the architecture reference
for details about the architecture.

Change-Id: I1f5da9acaa677b2cd752cda30c33eba846a96eb4
2018-03-20 11:44:57 +00:00
Jean-Philippe Evrard
7b4989d104 Point to Queens as previous branch
Change-Id: I73e8d8a05c24f70ff0c7801db711e8b945d6c364
2018-02-27 11:20:43 +00:00
Zuul
a173134f3b Merge "Replace http with https in app-resources.rst and delete useless url" 2018-02-25 08:38:05 +00:00
Jean-Philippe Evrard
99f4f17751 [Docs] Guide users more
- It's easy for a new deployer to miss the importance of the
  configuration. This highlights the step.
- It makes more sense to be guided from the deploy-guide to
  the Operations guide first, before the contributing.
- Reduced the commands to run for a first verification of
  the cloud.

Change-Id: I7bc7dce2d4a9f0449a3f70cc2717f5e0a8345dc4
2018-02-24 15:38:10 +00:00
wangqi
cfae99d913 Replace http with https in app-resources.rst and delete useless url
Change-Id: Icc5c8af5deba83a6bbd13a221ca5463afcb96e51
2018-02-24 01:14:31 +08:00
Jean-Philippe Evrard
f1a7525570 [Docs] Migrate security into user guide
Migrate all the security related user configurations into
a user story.

Change-Id: I4dfc5941abfd834d1d53a9c737db7afcce2841a0
2018-02-23 14:48:34 +00:00
Jean-Philippe Evrard
b6eb92beca [Docs] Move limited connectivity to user guide
This is a user story and should be treated as such.

Change-Id: Id7b7e58aaaf0630b9b1b99796c39eebbc28e0b04
2018-02-22 16:54:26 +00:00
Jean-Philippe Evrard
eb89fa513a [Docs] Centralize Inventory documentation
There are details about inventory configuration in the deploy
guide that could go to the reference.

Change-Id: I712470742250f37a410eb88087b14403ac777493
2018-02-22 16:18:07 +00:00
Jean-Philippe Evrard
99ca16e85e [Docs] Move network architecture into reference
Move all the design considerations into reference.

Change-Id: I5e5b4e85140b73871f2ba6a4d5264cb21de9f337
2018-02-22 09:49:44 +00:00
Jean-Philippe Evrard
d27e329a5a [Docs] Move Ceph example to user guides
Moving the ceph example into the user guide.
This structure also allows more text content, with for example
a guide for integrating with a ceph cluster deployed outside
OSA, and other ceph integrations (Rados GW for example)

Change-Id: Ib3eb33e23cfc50966b41842a02feeaf21f836450
2018-02-22 09:49:24 +00:00
Jean-Philippe Evrard
73c45a8108 [Docs] Move more examples to user guide
This moves the following use cases into the user guides:
- Prod example
- L3 routed example

Change-Id: I30c3d70701eaece4b3ec57a96be270ad01a28bad
2018-02-22 09:48:53 +00:00
Jean-Philippe Evrard
3d76d5e2e2 [Docs] Include test scenario as a new user story
This moves the appendix of the deploy guide into our user stories.

Change-Id: I0c0985987fba4610f825a36619aa2b043a730613
2018-02-21 15:21:51 +00:00
Jean-Philippe Evrard
dc8d6256ce [Docs] Move AIO to first scenario
With the ability to now have scenarii as first class citizens, we
can move the AIO.

Change-Id: I7d21bc49128b49bd6b2e6cf1b31938f1b81706d6
2018-02-20 14:14:41 +00:00
Jean-Philippe Evrard
ba7e064ef9 [Docs] Merge advanced configuration into reference
The deploy guide also have appendixes pointing to the reference,
which were pointing back to the deploy guide. This is very
hard to follow. The advanced configurations and inventory should
be merged into our reference guide, to avoid duplications.

Change-Id: I2d1e653036d380c3eae6a3a4906d1db890baecb2
2018-02-20 08:10:43 +00:00
Zuul
40a380ecc7 Merge "[Docs] Introduce next steps" 2018-02-19 12:50:21 +00:00
Zuul
b2e58685a6 Merge "[Docs] Unhide the ssl user story" 2018-02-19 12:48:08 +00:00
Zuul
84b151e5fd Merge "[Docs] Less scary landing page" 2018-02-16 17:50:08 +00:00
Zuul
06affa1e96 Merge "[Docs] Link to the AIO" 2018-02-16 17:50:06 +00:00
Jean-Philippe Evrard
152da42e4b [Docs] Unhide the ssl user story
The SSL was deeply hidden into the advanced configuration options,
while it's a common user story.

Change-Id: Ie09b94fb086f512ec1b233cb76754654ba032418
2018-02-16 15:17:24 +00:00
Jean-Philippe Evrard
29cefd5da3 [Docs] Remove duplicate hardening content
Simplify the documentation by removing duplications.

Change-Id: I1097f443b70f4093668045248a8301c13262742c
2018-02-14 14:27:25 +00:00
Jean-Philippe Evrard
b83ffe3680 [Docs] Introduce next steps
To be more like a walkthrough, the next step after the
verification of the environment would be to contribute and
operate OpenStack-Ansible.

This could also bring more visibility to contributions.

Change-Id: I991ad7963bcd777e279738bb9d4ca03992f46280
2018-02-14 13:52:23 +00:00
Jean-Philippe Evrard
cc9bb3e249 [Docs] Less scary landing page
Do not show a deep ToC when landing on the page, instead of show
a more user-friendly access page.

Change-Id: I0a571db85d67ff6a89b11adfbc72b0e27374bf9f
2018-02-14 13:40:58 +00:00
Jean-Philippe Evrard
25407b3999 [Docs] Link to the AIO
Anyone wanting to quickly deploy an openstack-ansible cloud has no
way to know we have an AIO toolkit that could help.

This should fix it.

Change-Id: I7cabfac0bfb01b77e2a250e5879671c95cbb46c6
2018-02-14 12:51:22 +00:00
Jean-Philippe Evrard
f391d52e2f Bump upstream SHAs
Bumping shas to head of stable/queens. For projects that don't
have that branch yet, a reminder was written on the same line as
the SHA.

Updates documentation to the appropriate branching.

On top of that:
- Placement API now only accepts GET, not HEAD
- Placement API now returns HTTP 200
- Designate returns the API versions under /, not under
  /versions [1]
- Cloudwatch was disabled upstream [2], so all references are
  removed.

[1]: https://developer.openstack.org/api-ref/dns/
[2]: https://bugs.launchpad.net/heat/+bug/1743707

Change-Id: I29e63008bf5c3cd8ed2deb8dcd13bc6a988891f5
2018-02-13 13:24:59 +00:00
Jimmy McCrory
c5551f2c8c Move inventory files to folder in root of repo
Move the playbooks/inventory folder, group_vars, and host_vars to
inventory/ in the root of the OpenStack-Ansible repo. This helps better
organize the repo structure since playbooks/ will now only contain
playbooks, shared task files, and included repo package var files.

group_vars and host_vars are moved alongside the inventory since that's
the default place that Ansible expects those folders and to help better
prepare for Ansible 2.4 where multiple inventories can be loaded,
automatically including relative group and host var files.

Effected docs, scripts, and variables have been updated with the new
paths.

Change-Id: If50e2412c3fd6575d7041deb8ecc9480b04184cc
2017-12-16 02:34:33 -08:00
Amy Marrich (spotz)
923f3c31e2 Update overview-osa for new supported Operating Systems
Updated for CentOS and OpenSUSE

Change-Id: I918fe0a36cc3a50c7a0e7964fb699bc7ccbbf2f3
2017-12-07 11:18:01 -06:00
Zuul
e33149c4bb Merge "[DOCS] Add alternative URL for cloning repo" 2017-12-06 04:34:47 +00:00
Amy Marrich (spotz)
dc78aff654 [DOCS] Add alternative URL for cloning repo
Added github.com URL as an alternative if issues with main repo.

Change-Id: I26623418ba5aea0cb79f502b02c7788e3bfccc6f
Closes-Bug: #1735942
2017-12-05 14:38:00 -06:00
Amy Marrich (spotz)
ffbb2321de [DOCS] Update links from pointing to developer-docs
Updated links for developer-inventory and developer-inventory-and-vars.

Change-Id: I95262bba8a55f8d5abe9fb59f89d314a9db8dd94
Closes-Bug: #1730688
2017-12-05 12:09:26 -06:00
Jean-Philippe Evrard
d5773de2a8 [Docs] Clarify ceph production example.
There are details that confuse people (like the usage of may), when
they are configuring a ceph environment.

This should clarify the situation.

Change-Id: Ic8b734eabcfa218c687db69290c8b3cef1def7c5
2017-11-28 17:04:19 +00:00