2320 Commits

Author SHA1 Message Date
Zuul
ae423e6b07 Merge "Reorganize the documentation front page" 2024-07-05 02:42:29 +00:00
Zuul
00dc3f10e0 Merge "Rework the navigation in the contributor guide" 2024-07-05 02:42:27 +00:00
Zuul
eda09db2a6 Merge "Fix rendering of Redfish properties in the documentation" 2024-07-04 17:27:24 +00:00
Zuul
a594e63c7f Merge "Add tox env for local dev; update documentation" 2024-07-03 10:18:28 +00:00
Jay Faulkner
3dcbc19541 Add tox env for local dev; update documentation
This is a quick and easy way to get Ironic up for testing; updated to be
even quicker and easier if you don't need multiprocess or mysql.

Co-Authored-By: CID <cid@gr-oss.io>
Change-Id: Ibef8a24868fd1f507e69e6d615d6327031d11495
2024-07-01 18:28:12 +00:00
Zuul
c63b56edfa Merge "Remove deprecated idrac wsman driver interfaces" 2024-06-28 18:44:45 +00:00
Julia Kreger
578f24bf18 Remove deprecated idrac wsman driver interfaces
Change-Id: I70738db25fdf9902575ac92195c3a40f1d7a0976
2024-06-24 15:03:28 -07:00
cid
3fd1fb3518 Follow up to change on testing CI on ARM
Setting the minimum needed for configuring devstack.

Related-Change: #915441
Change-Id: Ia94ebe2d2a1bd66cd03a4c833273b20ff15171f4
2024-06-24 20:00:53 +01:00
Dmitry Tantsur
656f93b6e7
Reorganize the documentation front page
This is largely inspired by the excellent feedback we got from David
Welsch, although this patch is only a very early first step towards
where we want to be with the documentation.

First, I'm splitting the large administrator guide into several large
sections: features, operation, architecture. Some of their topic might
actually find a better home outside of the administrator guide, but I
don't go that far in this change.

Second, I'm grouping several separate things together with the larger
topics:
- API topics are relevant for users and are grouped with the user guide
- Configuration guide and release notes are grouped with the
  administrator guide.
- The command reference is renamed for clarity and also grouped with the
  administrator guide since these are not user-visible commands.
- I'm dropping the "Advanced topics" subsection. While I like its
  intention (and I think it was me who added it in the first place),
  it's clear that such separation makes these topics much less
  discoverable.

Third, I'm playing with :maxdepth: here to make the sub-pages more
informative.

Change-Id: Icd0a35b252136b7da107c6346c48473cf1b99bcb
2024-06-24 13:25:51 +02:00
Dmitry Tantsur
a36fd00951
Rework the navigation in the contributor guide
The goal here is to give newcomers an easier overview of the contributor
guide. Currently, the index page only points at a couple of sections in
the contributor index, which may be confusing. So:

1) Expand the contributor reference from the index page one more level.
2) Update headings in the contributor guide to match the toctrees and
   their expected level.
3) Expand toctrees in the contributor index one more level.
4) Move references to the development enviroment to a higher level
   toctree to make them visible in the index.
5) Apply consistent upper case heading.

Change-Id: Ifb9fdc96b368095437771217090120e83eaa0fa7
2024-06-24 13:24:54 +02:00
Dmitry Tantsur
ef1ea4d36b
Fix rendering of Redfish properties in the documentation
The syntax we're using there is not valid, change to a definition list,
add double ticks and change a mention of an option to a link.

Change-Id: Idf37436d034fe8bb65bff92eddadfd82d7431df0
2024-06-21 17:01:50 +02:00
Zuul
0e5efe4d9b Merge "Fix and document redfish metrics" 2024-06-20 17:15:31 +00:00
Zuul
17c96e3e97 Merge "Documentation: migration guide from inspector" 2024-06-20 16:20:34 +00:00
Zuul
9a8147bb17 Merge "Decompose the Redfish documentation" 2024-06-20 15:48:42 +00:00
Zuul
19c8efd9d7 Merge "Provision ARM (aarch64) fake-bare-metal-vms" 2024-06-19 16:59:05 +00:00
Dmitry Tantsur
a88cc4d9de
Documentation: migration guide from inspector
Change-Id: I622085adc431555789921f04b5ba2375f806075e
2024-06-19 18:41:23 +02:00
cid
209ba79732 Provision ARM (aarch64) fake-bare-metal-vms
This commit introduces support for provisioning ARM (aarch64)
fake-bare-metal VMs in Ironic for the purpose of eventually supporting
CI testing on ARM64 architecture-based hardware.

Change-Id: Ie4bff8892228275ad0fb940c30e8071f7f4c423f
2024-06-19 03:17:05 +01:00
Julia Kreger
f14794ca2e Remove ibmc hardware type
There has been no testing of this hardware type in quite some time,
and the last we heard the vendor was moving towards redfish.

Change-Id: Ib32db463981ec54430884ac760956b7c7b40b17f
2024-06-18 16:33:35 -07:00
Julia Kreger
c02ad76fef Remove deprecated xclarity hardware type
Change-Id: I93e0d947d0f790bd4dfaa73e2cd31fdd36262af2
2024-06-18 16:33:00 -07:00
Dmitry Tantsur
d3fd725ef9
Fix and document redfish metrics
Provides a complete documentation for metrics that the Redfish
management interface can collect.

The Power payload refers to InputRanges in a broken way: this field is a
list, but the code treats it as a singular resource. No hardware I have
access to provides it this way. Since input ranges are constants and
thus arguably don't qualify as runtime metrics, removing them instead of
fixing.

Change-Id: Ida1be1341346df917073e649a23a2f116b262e66
2024-06-13 13:04:44 +02:00
Dmitry Tantsur
95784428a4
Decompose the Redfish documentation
This page is huge and keeps growing. So:
* Move additional topics to sub-documents.
* Move ESP creation to the install guide (it's not even
  Redfish-specific).
* Create a generic firmware updates document.

Provide a feature listing at the top for easier navigation.

Change-Id: Ic58c139da5e1e60f5ce4d2cec18972ebee9e2485
2024-06-13 12:37:11 +02:00
Zuul
89dae21abb Merge "docs: add some additional context around iPXE and secure boot" 2024-06-12 15:02:43 +00:00
Zuul
a51726ca08 Merge "Minor ramdisk interface docs update" 2024-06-09 08:42:25 +00:00
Julia Kreger
613348d112 docs: add some additional context around iPXE and secure boot
Change-Id: Ifecd92b80472b3e28307ddbdbaeeb08ec0950c54
2024-06-05 11:24:15 -07:00
Zuul
40f0980f9b Merge "docs: fix wrong configuration option name" 2024-06-05 18:11:35 +00:00
Pierre Riteau
7bb93f0d5e docs: fix wrong configuration option name
Change-Id: I1e8e028cc31ac2ca70afc2183196321f9e8a377d
2024-06-05 13:55:17 +02:00
Pierre Riteau
916b0f409b docs: fix markup
Change-Id: I8e23534db1e0a7e4385278732431f6531bf41075
2024-06-05 11:48:31 +02:00
Julia Kreger
e651e9986c Minor ramdisk interface docs update
Change-Id: I6b9249a01c0ef5997c750e6a07f877bd94bf239c
2024-06-03 15:45:11 -07:00
Zuul
8bdf1fca91 Merge "docs: augment security docs" 2024-06-03 22:09:04 +00:00
Julia Kreger
9f456bb63c docs: augment security docs
A quick review of the security documentation yielded a need
to revise and clarify the security documentation a little,
which includes a couple security related features.

And also fix the syntax on the example policy entries while
adding a missing third, ! results in a "default false" response.

Change-Id: I3d10ca4631703051109c443d5591a7e86f858c66
2024-05-31 07:04:30 -07:00
Zuul
2f41bf1a0d Merge "Fix some typo in servicing doc" 2024-05-29 15:40:22 +00:00
Zuul
7fafe27ba7 Merge "Add pre-commit configuration and docs" 2024-05-29 11:58:35 +00:00
Jay Faulkner
c6328874a5 Update front page of contributor guide
This highlights:
- The dev-quickstart guide, which is more up to date than most
  contributor docs.
- Common docs (OpenDev / OpenStack contributor guides)
- Bug information (also very up to date)

This removes:
- Top-level link to BfV and multitenant devstacks; these configs are
  linked from devstack-guide
- Hilariously out of date information around branch support

Change-Id: If47d9776c65c91b972a3fab8364eacc50a29b2bb
Depends-On: https://review.opendev.org/c/openstack/ironic/+/920365
2024-05-28 14:34:40 +00:00
Kaifeng Wang
a52cba727e Fix some typo in servicing doc
Some word refer to cleaning steps while should be servicing step.

Change-Id: I417635a0cbb8643d997bc317ad81772d411cd7bd
2024-05-28 19:30:42 +08:00
Julia Kreger
0d2a2e4bf4 docs: allow the state diagram to be larger
The state digram is constrainted into a frame of the page rendering
and the prior configuration set it to be a maximum of 660 pixels,
however we should allow the image to be aligned to page size which
can result in a larger image, but still constrained slightly so
spinx includes a link to the image.

Change-Id: I19350fc010bd5aac798b2d57ea3d2eb98239a457
2024-05-15 06:48:40 -07:00
Zuul
339e149c50 Merge "Add servicing states to states doc, fix state diagram" 2024-05-15 04:22:53 +00:00
Zuul
c31fea571b Merge "docs: Cleanup/revise Secure Boot docs" 2024-05-14 23:12:19 +00:00
Zuul
dcace881bc Merge "docs: revise notes around iso booting for clarity" 2024-05-13 16:37:25 +00:00
Jay Faulkner
74ecde7ea0 Add servicing states to states doc, fix state diagram
Good news, pydot (original) is maintained again and pydot2 apparently is
not. By switching to pydot instead of the fork, svg generation works
now.

This adds states for servicing, and swaps us back to svg for the
regenerated diagram.

Change-Id: I410182ee04293434d889747ddec229870c908d91
2024-05-10 14:31:55 -07:00
Julia Kreger
5a75e9afbb docs: detail limitation of use of config drive + rebuild
Change-Id: I2054d6a87d7dcf74004d3404c73e39a100f1fe9b
2024-05-07 10:31:34 -07:00
Zuul
5717c7e599 Merge "docs: document stance on partition image use" 2024-05-06 10:49:17 +00:00
Zuul
3134f13acf Merge "doc: Fix wrong example of [ipmi] cipher_suite_versions" 2024-05-06 08:34:34 +00:00
Takashi Kajinami
198e2ceb3b doc: Fix wrong example of [ipmi] cipher_suite_versions
The example suggests python-style representation but this is not
actually parsed as expected.

Change-Id: I21ce1db655f81cd3fb3a0a0b92f8b81ff1e77c45
2024-05-04 18:38:58 +09:00
Jay Faulkner
9c955685c4 Add pre-commit configuration and docs
pre-commit is a git hooks framework which does lots of useful things
before you commit, like validating lint and codespell -- easy things to
forget, especially in a post-codespell world.

Related-bug: 2047654
Change-Id: I22738f9dceebe194e5aedff8815cd786013de456
2024-05-01 14:00:30 -07:00
Julia Kreger
021117e354 docs: revise notes around iso booting for clarity
Had someone try to boot the tinycore ISO on a UEFI machine, and they
got a nice error. Just turns out we needed to update our docs a little
bit to provide appropriate clarity.

Change-Id: I1adfb62ea22d0b58740ceadc8c338fc04d9b78de
2024-05-01 10:14:20 -07:00
Zuul
06c492aad5 Merge "Remove special treatment of .json for API objects" 2024-05-01 04:55:26 +00:00
Takashi Kajinami
1e4ef9395a Remove old excludes
These are detected as errors since the clean up was done[1] in
the requirements repository.

[1] 314734e938f107cbd5ebcc7af4d9167c11347406

Also remove the note about old pip's behavior because the resolver
in recent pip no longer requires specific order.

Change-Id: I742ea0192398b9e9b78b969fa81f65621d9490de
2024-04-30 22:43:13 +09:00
Zuul
b6b8ee07ce Merge "Replace glanceclient usage with openstacksdk" 2024-04-29 15:26:56 +00:00
Zuul
08209c48ab Merge "docs: update ilo docs regarding status -> use redfish" 2024-04-29 08:30:06 +00:00
Steve Baker
978afbd5a1 Replace glanceclient usage with openstacksdk
Closes-Bug: #2042495
Change-Id: Ic8421bd937a3a1ab6c3b86c259cd929810c0532e
2024-04-29 12:30:33 +12:00