summaryrefslogtreecommitdiff
path: root/doc/source
Commit message (Collapse)AuthorAgeFilesLines
* Update create node from file exampleJulia Kreger2020-10-211-5/+10
| | | | | | | | The file was out of date with the removed *_ipmitool drivers and the driver_info field which should be posted on node creation to the API. Change-Id: I18ece4f2472a0aced2874992c18a8871665f9621
* Remove pypywu.chunyang2020-07-031-1/+1
| | | | | | Pypy is not tested in OpenStack anymore, remove the job. Change-Id: If462d6a5e2304ebc6647087cad89007fe2576acb
* Fix pygments stylemelissaml2020-06-231-1/+1
| | | | | | | | New theme of docs respects pygments_style. more info: http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html Change-Id: I5152536f4b499c0adfea8e1a392503f031475940
* Switch to newer openstackdocstheme and reno versionsAndreas Jaeger2020-05-181-2/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | Switch to openstackdocstheme 2.2.0 and reno 3.1.0 versions. Using these versions will allow especially: * Linking from HTML to PDF document * Allow parallel building of documents * Fix some rendering problems Update Sphinx version as well. Remove docs requirements from lower-constraints, they are not needed during install or test but only for docs building. openstackdocstheme renames some variables, so follow the renames before the next release removes them. A couple of variables are also not needed anymore, remove them. Set openstackdocs_pdf_link to link to PDF file. Note that the link to the published document only works on docs.openstack.org where the PDF file is placed in the top-level html directory. The site-preview places the PDF in a pdf directory. Set openstackdocs_auto_name to use 'project' as name. Depends-On: https://review.opendev.org/728938 Change-Id: Ic9b4859ad14431c2ab6cc67e053757c0e728d40e
* Standalone CLI: fix a minor issue in the docsDmitry Tantsur2020-04-081-4/+4
| | | | Change-Id: I4bc7ea354489b54386303ff4f956c86eb953e3b8
* Standalone CLI: optional support for ironic-inspectorDmitry Tantsur2020-04-071-0/+28
| | | | | | | | To provide a `baremetal introspection` CLI interface similar to the existing OSC plugin, this change adds optional support for pulling commands from ironic-inspector-client. Change-Id: I61b82af3afdd934ed130d3d700de8ec7423a1328
* A standalone CLI for ironicDmitry Tantsur2020-04-063-5/+81
| | | | | | | | | This changes adds a new command ``baremetal`` that works mostly like the OSC ``openstack baremetal`` command but does not require OSC and defaults to no-auth. No changes in existing commands are required, the existing OSC plugins are pulled in. Change-Id: Id4895ec37bfb58eb635e5c8519f96f1bdc30c925
* Fix source link.wangfaxin2019-10-171-1/+1
| | | | Change-Id: Iad6e3997f7f8e3a96208a39b2cec0db9666ce32b
* Build pdf doc3.0.0Kaifeng Wang2019-09-051-8/+5
| | | | | | | | | | | | | | | | | | | | The is one of community goals that each project could 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: I60e1e1b02ced34a7236fca4552ecf2f983cdb9d4
* Remove the ironic commandJulia Kreger2019-08-204-123/+3
| | | | | | | | | | | | | | | | | The ironic command is dead, long live the OSC baremetal command. Also removed the json_respose tests, which seemed ot be geared to checking json returned data on the command line. For ironic these tests seemed to be very explicit for our CLI where as OSC should be covering the return data handling, the only real end effect is field level expectation enforcement in the functional test... which seems excessive and un-needed. Story: 1726605 Task: 11974 Depends-on: https://review.opendev.org/677183 Change-Id: I3e3ae416a65d8e01956434ba51bd3187ab001f80
* Fetch requirements from opendevKaifeng Wang2019-05-083-4/+4
| | | | | | As well as doc updates Change-Id: I994dfe226d81494c01c105e5c62c4fe7c3b9875e
* Allocation API: client API and CLIDmitry Tantsur2019-02-161-0/+7
| | | | | | | | | Adds the Python API to create/list/view/delete allocations, as well as the OpenStackClient commands. Change-Id: Ib97ee888c4a7b6dfa38934f02372284aa4c781a0 Story: #2004341 Task: #28028
* Change openstack-dev to openstack-discusszhulingjie2018-11-181-1/+1
| | | | Change-Id: I37f82ff856999a53f7fa43daccaff115530a9a1f
* Include python API reference in docsVladyslav Drok2018-05-313-1/+10
| | | | | | Also move the autogenerated docs to the reference folder. Change-Id: I3e5a34c8a486bf022a940967fec9d5fc939c4489
* Follow the new PTI for document buildNguyen Hai2018-04-192-6/+11
| | | | | | | | | | | | - Follow new PTI for docs build - Add sphinxcontrib.apidoc to replace pbr autodoc REF: https://governance.openstack.org/tc/reference/project-testing-interface.html http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html http://lists.openstack.org/pipermail/openstack-dev/2018-March/128594.html Change-Id: I76e8ec019ef30fdc2d34a25a99e849407f586459
* Update references to launchpad for storyboardJulia Kreger2018-03-281-16/+1
| | | | Change-Id: Ia0b4089dd1e1d5a7872fb07f9233af6b18845917
* [doc] Add 'openstack create' command to command referenceRuby Loo2018-03-141-0/+7
| | | | | | | | This adds the 'openstack create' command to the Command Reference section of the 'openstack baremetal CLI' documentation. Change-Id: Id31e0c7d7f6dc15bfb22a337cfc4798b43c52327 Closes-Bug: #1755847
* Update 'Usage' section in 'doc/source/api_v1.rst'ya.wang2018-02-221-0/+7
| | | | | | | | | | | When I want to get the client with 'Using Identity Service (keystone) credentials' section, it will throw errors.(usually http 400) After testing it is found that two variables aare missing: - os_user_domain_name - os_project_domain_name Now added them to the document. Change-Id: Ibdebc7cf0fc017b7eeb378b022ce5cffcd943fb2
* Deprecate the ironic CLIRuby Loo2017-10-113-2/+12
| | | | | | | | | | The 'ironic' CLI is being deprecated; it is slated for removal in the S* release cycle. The 'openstack baremetal' CLI should be used instead. A message is printed out to that effect and the documentation is updated to reflect this. Change-Id: Ie6ac3c6222ec6a6231b9a9cb2949cac56b48967f Closes-Bug: 1700815
* Update documentationRuby Loo2017-10-035-51/+40
| | | | | | | | | | | | | | This updates the documentation. Changes include: - putting 'openstack baremetal' commands before 'ironic' commands, since the plan is to deprecate the 'ironic' CLI - fixing formatting issues - removing the description for the 'openstack baremetal create' command about how it can be used for creating a node -- this functionality has been deleted. - in the examples, using hardware types instead of classic drivers, since the plan is to deprecate classic drivers Change-Id: I09fdf160122664d923361a8a8c80c61aba347c30
* Fix to use "." to source script filesmelissaml2017-09-011-1/+1
| | | | | | | Adhering to coding conventions. Refer to ``Code conventions`` at https://docs.openstack.org/contributor-guide/ for details. Change-Id: I4637129b2379aa114214e83f8ca1b6786a5e3160
* Add auto-generated CLI referenceMichael Johnson2017-08-233-0/+51
| | | | | | | | | | | | | | The Ironic OSC plugin CLI was not being fully documented. This patch enables an auto-generated CLI reference for the OSC plugin. Note: There is a formatting issue with required arguments that include a hyphen. This has been opened as a bug [1]. [1] https://bugs.launchpad.net/python-cliff/+bug/1712612 Closes-Bug: #1712099 Change-Id: I541214f3b3bab9af0ae79c8055dfa1f151560b21
* Turn on warning-is-error1.16.0Julia Kreger2017-07-262-8/+8
| | | | | | | | In the doc-migration, warning-is-error was never enabled for python-ironicclient. As such, I've enabled it and corrected the various document errors. Change-Id: I2d1b95fba25dba5d59da3f4b09b9974ff5196940
* Update and optimize documentation linksHangdong Zhang2017-07-181-6/+6
| | | | | | | | 1. Update URLs according to document migration 2. Update the dead and outdated links 3. Optimize (e.g. http -> https) Change-Id: I63c0f87a6a0b1e0c36dfbd52cef65ede376ae222
* Rearrange existing documentation to fit the new standard layoutLuong Anh Tuan2017-07-148-12/+26
| | | | Change-Id: If0c0789ac730c565477b9053d63375c67667b0d1
* switch from oslosphinx to openstackdocsthemeLuong Anh Tuan2017-07-041-1/+9
| | | | | | | Move doc/ and releasenotes/ to openstackdocstheme and remove the dependency on oslosphinx. Change-Id: Iac55f25a96959024f91b8bb689f5fba9325dbb52
* Merge "Add usage documentation for Baremetal OSC Plugin"Jenkins2017-05-042-0/+86
|\
| * Add usage documentation for Baremetal OSC PluginKyrylo Romanenko2017-05-032-0/+86
| | | | | | | | | | Closes-Bug: #1619416 Change-Id: Iccc5d22636539b989926c43a070e481be0eb4676
* | Change tenant to project in docs and unit testsKyrylo Romanenko2017-02-022-3/+3
| | | | | | | | | | | | | | | | | | | | Change os_tenant_name to os_project_name in documentation, client and shell unit tests. This is follow-up change augmenting the patch https://review.openstack.org/#/c/408235/ for consistency. Change-Id: Iaea3ddc71dadc2991e56667988df82aa1cfaf525 Related-Bug: #1646837
* | Merge "Allow creating portgroups via create commands"1.11.0Jenkins2017-01-251-14/+29
|\ \
| * | Allow creating portgroups via create commandsVladyslav Drok2017-01-251-14/+29
| |/ | | | | | | | | | | | | | | This change allows specifying portgroups (that themselves may contain ports) inside the nodes dictionaries. Related-Bug: #1618754 Change-Id: I858412d135717e78291bbef8b0861ef00c5d4fdb
* | Merge "Change os_tenant_name to os_project_name in tests configuration script"Jenkins2017-01-251-1/+1
|\ \
| * | Change os_tenant_name to os_project_name in tests configuration scriptKyrylo Romanenko2017-01-181-1/+1
| |/ | | | | | | | | | | | | | | | | OS_TENANT_NAME variable is deprecated in Devstack. Replace it with OS_PROJECT_NAME variable in configuration script tools/run_functional.sh which generates config dynamically. Change-Id: I7b2fab37aeae6e37672b9b92f0b5ae49a1b2e2d9 Related-Bug: #1646837
* | Typo fix: prefered => preferredAnh Tran2017-01-231-1/+1
| | | | | | | | Change-Id: I7d34d595b0f192d8531a6a85f73c6911c864c36d
* | Merge "Update tox envs list"Jenkins2017-01-111-1/+1
|\ \
| * | Update tox envs listKyrylo Romanenko2017-01-101-1/+1
| |/ | | | | | | | | | | | | Update envs list in tox.ini: py33, py34 are not run on CI anymore. Make documentation consistent with actual settings in tox.ini. Change-Id: I7e6ad8acf01a54043f2a2b741c0f1b3376c936d0
* | [trivial] Fix underline length under title in docKyrylo Romanenko2016-12-281-1/+1
|/ | | | Change-Id: I71bf7c4a228eae155f6a44ada75e341f623e5af1
* Merge "Add docs for create command"Jenkins2016-10-132-0/+175
|\
| * Add docs for create commandVladyslav Drok2016-10-062-0/+175
| | | | | | | | | | | | | | | | | | This change adds documentation on usage of create command and create_resources module in client for resources creation. Closes-Bug: #1588339 Change-Id: Ia53e3db4e249aca197d4fa25a70ea1ca98a3da11
* | Add prefix "$" for command examplesYushiro FURUKAWA2016-09-292-18/+18
|/ | | | | | This commits adds "$" as a prefix for command examples. Change-Id: I372cee5305acc26115ff4ffca58aaa2283a3a033
* Add docs target to tox.iniVladyslav Drok2016-08-191-0/+5
| | | | | | | Also fixes tempest imports related errors and adds warnerrors=True for pbr in setup.cfg. Change-Id: Ib27b5de1f014ebae0b66e945ed5a7628913c3a41
* Merge "Fail with more meaningful error while creating client"Jenkins2016-08-181-1/+6
|\
| * Fail with more meaningful error while creating clientAnton Arefiev2016-08-151-1/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | Parameter 'endpoint' in v1 client object is mandatory if os_ironic_api_version isn't specified. It's used to fetch version from cache[1] and as endpoint override in session client[2]. But since it passed via *args, it could be missing, and creation fails with IndexError. [1] https://github.com/openstack/python-ironicclient/blob/master/ironicclient/v1/client.py#L42 [2] https://github.com/openstack/python-ironicclient/blob/master/ironicclient/common/http.py#L595 Change-Id: I0310f748a1254dd7e54d93f913cff53aadaff16b
* | Merge "Fix Quick-start example syntax."Jenkins2016-07-211-1/+1
|\ \
| * | Fix Quick-start example syntax.Vasyl Saienko2016-07-131-1/+1
| |/ | | | | | | | | | | This patch fixes syntax of example provided by documentation. Change-Id: I2f6a5361a2dd4af1357a99e470eef2eed9a6b4cd
* | Add release note link for client release notesChris Krelle2016-07-141-0/+1
|/ | | | | | Add a link to client release notes to the index page. Change-Id: I871aace4e255d400f0a75318688926e40f95b551
* Add documentation on how to run testsSergey Turivnyi2015-11-182-0/+68
| | | | | | | | | | | | Added a testing page to the documentation. This includes information on: * Running PEP8 checks * Running unit tests * Running functional tests Closes-bug:#1511731 Change-Id: I4a5cf4be98f32455e36ea7d6a45b18afca043809
* Use doc8 style checkerRuby Loo2015-09-302-3/+6
| | | | | | | | | | | This uses the doc8 style checker to check that document files conform to certain requirements, as documented at https://pypi.python.org/pypi/doc8. Some files were modified because they had lines that were longer than 79 characters. Change-Id: I94e081e197898359676821cfcf8cb1133ed28bc5
* Remove unneeded 'utf-8' coding linesJohn L. Villalovos2015-04-211-3/+0
| | | | | | | | | | | | | | | | | | This is basically a revert of commit: af741ec2236619880fa902d68aef4a6ae6cef534 It was decided that only files that need to have the line: # -*- coding: utf-8 -*- Should have the line[1] as a general principle This patch removes the 'utf-8' coding line from files that consist entirely of ASCII characters. [1] http://eavesdrop.openstack.org/meetings/ironic/2015/ironic.2015-04-20-17.00.html Partial-bug: #1325193 Change-Id: I88c1c37f7b580aa805eae9d4a1e66d33302a325f
* Fix Python Ironic Client DocumentationDiego de Lima Pereira2015-02-131-2/+2
| | | | | | | | | In the 'ironicclient Python API' page, the credential section has a little mistake in the example. It's missing "," in the first line and a '}' in the last. You can see it at http://docs.openstack.org/developer/python-ironicclient/api_v1.html Change-Id: I195f46ca7261390b0d6321bc6bdd7e8d0908af40