52 Commits

Author SHA1 Message Date
Dmitry Tantsur
6df83e0bc5 Stop using deprecated OS_URL
It is being removed from OSC in https://review.opendev.org/#/c/677795/.
Apparently, setting OS_AUTH_TYPE=none works now.

Change-Id: Ib910a50c8ad01abc0a6058c400a7eb875d3b6b77
2019-08-28 15:46:22 +02:00
Radosław Piliszek
c4847323bf Fix troubleshooting docs - SSH access to CoreOS
Removed setting was used and the second step was unclear.
I updated the procedure to match current state.

Change-Id: I10ce74a1c1a7355837b283c372737c9b06ae2e85
Signed-off-by: Radosław Piliszek <radoslaw.piliszek@gmail.com>
2019-05-31 10:30:04 +02:00
Riccardo Pittau
5ebea663cc Update sphinx requirements
Following recent changes to global requirements [1], we need
to update sphinx requirements locally.

[1] If558f184c959e4b63b56dec3ca1571d1034cfe5c

Change-Id: I9088c6a63f9cf51dd17f576c6b675278646836b6
2019-05-23 10:27:10 +02:00
Zuul
80827010d5 Merge "Switch to Debian Stretch for building DIB images" 2019-04-24 08:22:02 +00:00
Monty Taylor
ec852a3fad Update links for opendev
The most important bits are updating shade references to remove
the openstack-infra. The other git urls will work through the
redirect, but cleaning them up is just nicer.

This removes two comments that reference files that no longer
exist due to config generation.

Also, fix some random use of github for cloning openstack repos,
since the github mirror is best-effort only.

Change-Id: I55a1d9db940cf5fa2c35421db7add015ae334563
Needed-By: https://review.opendev.org/654056
2019-04-22 17:16:46 +02:00
Dmitry Tantsur
98bc3fe537 Switch to Debian Stretch for building DIB images
It seems that Jessie is no longer supported, and its backports repo
is no longer available, hence all DIB jobs fail.

Depends-On: https://review.openstack.org/#/c/653453/
Change-Id: I7973c8da057a678e6285ecc9418a4862bc1d3feb
2019-04-18 11:04:53 +02:00
KaiFeng Wang
bfe8181235 Remove oneview from document
oneview driver is no longer supported upstream.

Change-Id: I0fffb51ccb5a2a61c70b322ec5f13f6aeb9dc64a
2019-04-03 09:38:02 +08:00
Mark Goddard
6a0ef585a9 Update env-vars and openrc to use openstack CLI
The ironic CLI is deprecated, and use of OS_AUTH_TOKEN causes problems
when set during deploy-dynamic.yaml, so we should move to recommending
use of the openstack CLI instead.

Change-Id: I7aa969385962008505db3115fc7e86b2729f26ee
Story: 2005034
Task: 29523
2019-02-20 18:50:21 +00:00
Zuul
1b089d9311 Merge "remove those copy words occured twice times in offline-install.rst" 2018-11-15 11:25:22 +00:00
zhouxinyong
68bc38ecaf Applying the HTTPS protocal.
To keep the website in this file be more robust,
we'd better update the links to HTTPS type

Change-Id: Idbc5e0ebd1e4b20b79da2a79d77fa0ddd662f19a
2018-11-15 07:37:51 +00:00
zhouxinyong
ad763bf832 remove those copy words occured twice times in offline-install.rst
Change-Id: I6ffb3a656bf8f04015a664d0e3f7702008b780b6
2018-11-13 10:40:05 +08:00
zhang.lei
36031ed30a Migrate the link of bug report button to storyboard
Change-Id: I9d61fd055cff4d2ad075a2ee71544a90a1ed5412
2018-08-22 07:36:14 +00:00
Nguyen Van Trung
460a8f6be3 Follow the new PTI for document build
For compliance with the Project Testing Interface as described in:
https://governance.openstack.org/tc/reference/project-testing-interface.html

For more detials information, please refer to:
http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html

Change-Id: I3eb92c968ece3c15eeae59bb6ef9492f3d03eeed
2018-07-10 16:33:42 +00:00
Olivier Bourdon
0e4456ae3a Fix for proper deployment when keystone enabled and minimal OS
Due to the fact that the openstack CLI can not be found on
the minimal OS (Ubuntu Xenial + OpenSSH server ~ 363 packages)
and that some tasks related to Keystone use this utility
it should be installed like the other Ironic CLIs

Change-Id: I3c2056cd1fe8551ca7dcb7f122e8982d5f9301a5
Closes-Bug: #1747349
2018-02-07 16:08:51 +01:00
gaofei
b2b168d4ef Fix unreachable link in document
Fix unreachable link in document.
Tivial fix.

Change-Id: I9399afe4769cb082d52fe7cfa97ce9ede59528b6
2018-02-07 17:26:21 +08:00
Olivier Bourdon
01b2c3bb64 Add creation of openrc file when keystone enabled
Change-Id: I250b202c4a319604bcd910e49c1d55bcad9e38e3
2018-02-06 11:26:58 +01:00
Julia Kreger
46453661ba Deprecate Classic Drivers
Switches bifrost to use hardware types
and deprecates the use of classic drivers.

Change-Id: Ib0cd547c90bf943846eb7923cd90bfb2bca557fa
2018-02-02 12:08:42 -08:00
Nguyen Van Trung
7047a329b5 Add doc8 into pep8 check to scan rst files
This change will help fix pep8 issues of all *.rst files
in the project and checking for new files.

Change-Id: Ib06aeb7fa76bd387d76c23bc3f8ecca89332d989
Co-authored-By: Hoang Trung Hieu <hieuht@vn.fujitsu.com>
2017-11-29 13:13:15 +07:00
melissaml
9819720f78 Fix to use "." to source script files
Adhering to coding conventions. Refer to ``Code conventions`` at
https://docs.openstack.org/contributor-guide/ for details.

Change-Id: I54b2d7d84bdd651fb96a62b3af3244c6ab484059
2017-09-20 02:58:52 +08:00
shangxiaobj
2c6d130f0b Update and replace http with https for doc links
1) Update doc links according to OpenStack document migration
2) Use https instead of http for docs links

Change-Id: I66ec684f89a842f73f5854ad70c35c8a3d8334dc
2017-09-19 15:08:48 +00:00
Jenkins
944bcf0ba5 Merge "Enable usage of no_proxy on install" 2017-08-11 15:14:06 +00:00
Jenkins
f1f0b3153e Merge "Fix rendering in README" 2017-08-11 13:57:45 +00:00
KaiFeng Wang
dd9782d20e Enable usage of no_proxy on install
http_proxy and https_proxy are passed as enviroment variable, while
no_proxy is not taken into account during bifrost installation.

This patch add no_proxy environment variable to Ansible.

Change-Id: I5eaaf86ff08ca7189aa63b0a709be48e189b5f7c
Closes-Bug: #1708322
2017-08-11 17:35:10 +08:00
Dmitry Tantsur
864c498528 Fix rendering in README
It is included into doc/source/index, so its heading levels have to be
compatible with ones there. The same goes for MISSION.

Also fixes incorrect link syntax.

Change-Id: I71f575b72abad0c5992be841ac3ee5ea1094537d
2017-08-11 11:34:49 +02:00
Julia Kreger
aad9617163 Centralize user documentation
Change-Id: Icf1643f3d6c87a596e6a6b5cdb73dced42ea0797
2017-08-11 09:09:22 +00:00
Julia Kreger
bc0a12dfff Begin breaking out installation documentation
Broke out install related content, and linked the
mission statement in to the main index page.

Change-Id: I439e07429f9862f57520c7f92f5b0814536c0ffc
2017-08-10 19:02:02 +00:00
Arundhati Surpur
234226a154 Removes unnecessary utf-8 encoding
This patches removes unnecessary utf-8
encoding in doc/source/conf.py

Change-Id: I95e7fe0c848c47b483c28fb104aed0d795745918
2017-07-22 00:54:05 +05:30
Julia Kreger
531c695a74 Switch from oslosphinx to openstackdocstheme
As part of the docs migration work[0] for Pike we need to switch to use
the openstackdocstheme.

[0]https://review.openstack.org/#/c/472275/

Change-Id: Ifcfdaf8247ed52e57ed8ccb31338eb492df10e0e
2017-07-11 19:55:53 +00:00
Julia Kreger
67977f9885 Enable warning-is-error for doc builds
Some of the documentation linking is broken, and will need
to be fixed as the documentation is revamped for the doc
migration.

Change-Id: I23a5f8a7c0cc7b0ce19052a2383e20b96e195996
2017-07-11 19:37:30 +00:00
Yolanda Robla
34bccf2fa4 Allow looking constraints file from env var
In order to make it more flexible, and to consume the upper
constraints file from the right branch, allow to consume an
exported var, and default to the current path.

Change-Id: I57ef2944f4c2b643d240f30cac46ad91662ff538
2017-04-03 10:14:37 +02:00
Mark Goddard
92eb477798 Allow undionly.kpxe boot option to be overridden
As an operator, I may wish to provide DHCP boot options for hosts not
managed by bifrost using the bifrost dnsmasq server.

If a dhcp-boot configuration option is provided to dnsmasq via a file in
/etc/dnsmasq.d/, and the server is not booted via iPXE, it will be
overridden by the undionly.kpxe option added by bifrost in
/etc/dnsmasq.conf.

This occurs because the negated tag match !ipxe used in the
/undionly.kpxe dhcp-boot entry will match all hosts not using iPXE. The
dhcp-boot entries are processed in order and the last matching entry
wins. Since the config-dir option appears before the dhcp-boot options,
user-provided options are processed first and are therefore overridden.

The solution here is fairly simple - use a positive match for the ipxe
tag:

dhcp-boot=tag:ipxe,http://host:port/boot.ipxe
dhcp-boot=/undionly.kpxe

An entry with a tag will always win over the entry without a tag
specified, so it is now possible to add a rule to override
undionly.kpxe.

Change-Id: Ic0637e14504def73fbc0333eee9dc2456c57c32e
Closes-Bug: #1675367
2017-03-27 11:21:52 +01:00
Pavlo Shchelokovskyy
3aaed64e88 Use JSON baremetal data in testing
To move bifrost testing to *_ipmitool drivers + virtualbmc, we need
the baremetal data file to support ipmi port setting, as in the case of
virtualbmc, all test VM nodes use the same local IPMI address with
different port per-node.

Unfortunately, the CSV baremetal inventory format that is used in our
testing procedures does not support setting IPMI ports.

As the CSV format is considered a legacy format, let's move testing to use
JSON-formatted baremetal data instead of fixing the legacy format parser.

Changes are mostly to 'bifrost-create-vm-nodes' role and it's callers.
Some level of backward compatibility is provided:
- baremetal_csv_file var is still accepted, and its value is used as
  path to write data, although the data will nevertheless be in JSON format.

An extra helper script is added to reduce the number of nodes in
inventory when testing DHCP.
Also the script in 'bifrost-test-dhcp' role is changed to support
loading data from JSON.

This change officially deprecates using CSV formatted baremetal inventory
files.
Handling CSV baremetal inventory files will be removed in the Queens
release.

Change-Id: If2dcf43857195611ef342fe602330878378b021b
Partial-Bug: #1659876
2017-03-06 17:06:30 +02:00
Julia Kreger
7fad2491e7 Documentation cleanup
Reordering documenation for a cleaner presentation
of details, and centralization of howto information.

Change-Id: I758161b46cb19b8871e59cd2b3fcddbfc009b785
2017-03-02 18:55:41 +00:00
avnish
3a31ba4d0c Remove link to modindex
The documentation build does not generate any module index, thus
remove the link to the page.

Change-Id: I4f9fb30f231121ab4b79b21009d052cf044ba791
2017-02-02 17:00:39 +05:30
Andrey Shestakov
c6e2851819 Fixes to allow install Ironic on remote node
This change introduces fixes, which allows install Ironic on remote
server. This may not complete list of changes required for all
operations.
Also added group 'target' to inventory file, which is same as localhost
by default, and host in this group can be replaced by remote host.

Change-Id: I59c942d2556c5e1b7eee661fb8cf13c4ae02b2d1
2017-01-23 13:28:12 +00:00
Julia Kreger
cf77dd9f70 Minor documentation updates
* Adding keystone support reference to documentation.
* Adding Xenial to the list of supported Ubuntu distributions.

Change-Id: Id093d2e474c6e9501599431342d208886d04444c
2016-12-06 16:30:50 +00:00
Julia Kreger
2cf5ce5252 Add initial keystone use documentation
Using keystone is a bit of an advance topic, but documentation
is required to allow users to hopefully grasp the essentials of
what is required.

Change-Id: I25fd57f9acf07420384f021d17a43cf73412a965
2016-12-02 18:31:20 +00:00
ZhiQiang Fan
e44016b7ae [Trivial] Remove executable privilege of doc/source/conf.py
It is a configuration file, rather than a script.

Change-Id: I2ead10575e9e306ec412d3ee20358bd043a81a72
2016-04-29 21:19:33 +08:00
Yolanda Robla
5553ccab81 Add inventory_dns feature to bifrost
This will allow to configure addressing based on inventory

Change-Id: I71517146a197e39ed8ff2205e4234685d95331ad
2016-01-15 15:58:25 +01:00
Julia Kreger
ac6a4be65d Correct DHCP configuration examples
The intermediate chain loader URL, for our TFTP configuration
requires a leading / to match the file in order to serve up the
user's request.

Added leading "/" to the configuration examples.

Change-Id: I8bec59400f013b2912f836b3619bea2e078f564c
Closes-Bug: #1524505
2015-12-09 16:10:54 -05:00
Clint Byrum
b0d8b037fa Add static DHCP for dynamic inventory
In some cases it is simpler to just configure the images being deployed
to use DHCP, rather than teach them how to put the IP address in the
configdrive in the right place. This will setup dnsmasq to send the
static address for the box. It will use that address for the deploy as
well.

Co-Authored-By: Clint Byrum <clint@fewbar.com>
Co-Authored-By: Gregory Haynes <greg@greghaynes.net>
Co-Authored-By: Julia Kreger <juliaashleykreger@gmail.com>
Change-Id: I524958be5e787d42c91278baf2c4a14beb965e7c
2015-10-06 08:12:37 -04:00
stephane
226ebe9642 Cleanups for README.vagrant
Assorted cleanups for this readme, including:
- Move file to .rst extension
- Fix bulleted lists
- Mark up literals
- Fix typos

Change-Id: I66f8454c671b3d8d8f126304875285e2599f7dde
2015-09-14 08:44:24 -04:00
stephane
dc6bcb0ea4 Clean up troubleshooting.rst markup
Do some cleanups on our troubleshooting doc, including:
- Add the doc to the tree of stuff that gets rendered
- Correctly mark up literals
- Consistent capitalization for Ironic/Bifrost
- Make list autonumerate for ease of maintenance

Change-Id: I29dc39bf5b88588d19626af566d2e7d29fdacf48
2015-09-11 14:22:20 -07:00
stephane
f2c5cee22e Add new docs to index
Some of our documentation wasn't in the index. Add it. Also
clean up one bulleted list which was causing some errors.

Change-Id: I5459d8914ddef905e7783a711477bad116d585a8
2015-08-05 11:09:35 -07:00
stephane
cfe024a210 Clarify variable names & cleanup docs
The deploy_kernel* and deploy_ramdisk* variables were confusingly
named because they looked similar to deploy_image. I've renamed
them to ipa_kernel* and ipa_ramdisk* to reflect that they are the
CoreOS kernel and ramdisk from IPA and have updated the
documentation. I also cleaned up a minor issue where we defined
a path for the local copies of the kernel and ramdisk but didn't
use it in the install playbook.

I've also removed deploy_image_upstream_url from the offline
installation documentation as we no longer use it.

Partial-Bug: 1478726
Change-Id: Ia8c865521974e6bdd9e8e6a3ffa4c5f6b1f2f6ad
2015-08-03 10:26:27 -07:00
Devananda van der Veen
7b315c8b0f Vagrantfile and vagrant.yml for testing
Also adds a readme file for vagrant.

Change-Id: I46e60bdda83db8733019cdbcd8c2c326f3f1e1a8
2015-07-23 11:09:03 -07:00
Peter Martini
94e2f9a4e3 Allow env-setup.sh to use alternate url/branches
For an offline install, env-setup.sh needs to be able to clone
from locations other than GitHub.  Additionally, since
the ansible repo will have to have its .gitmodules file patched
to point submodules to some other location as well, its convenient
to allow for alternate branches.

As a side-effect, this moves the documentation of what branch
we're using to the top of the script for easy reference and removes
the duplicated branch name.

Change-Id: I7432531915c03638aaf52f836cda607d424351ba
2015-07-02 07:00:15 -04:00
Peter Martini
a2f468c682 Move explicit URLs in ironic-install to defaults
To facilitate offline installs, any explicit URLs should be
moved to a location where they can be easily overridden with
a local equivalent.

That way, a default install will use the canonical location, but
a user can easily override this behavior in inventory.

(Such gymnastics are not necessary for apt/yum/pip, because those
can be configured to point to local/alternate repositories independently).

** WIP - Needs *better* documentation **

Change-Id: I9dada2fe769e30abc06dac092b9f47b99969a954
Closes-Bug: #1464787
2015-06-18 08:09:43 -04:00
Jenkins
7319c65466 Merge "Add cookiecutter-generated files for project" 2015-06-10 18:55:59 +00:00
Jenkins
2a9d49d9bc Add cookiecutter-generated files for project
Use cookiecutter (https://git.openstack.org/openstack-dev/cookiecutter)
to generate config for tox so we can generate docs, run pep8, etc.
Also move CONTRIBUTING.rst to the root of the repository in keeping
with what seems to be the standard location. This move allows us to
easily generate the docs. Also include a tiny fix to allow pep8 to
run cleanly.

Change-Id: Ifbfc6d85c7b02bf4ab989974b491a3a1ae6f0900
2015-06-10 08:40:19 -07:00