* Update charm-deployment-guide from branch 'master'
to 9cc926c3943acc607e822b800e8172ad1e6bff3f
- Merge "Trivial improvement to configure page"
- Trivial improvement to configure page
This PR will also be used to generate a 2023.2 version of the
Deploy Guide.
Change-Id: I25f24ffe61e0d6293fd6b1efe3287ef7e48da489
Signed-off-by: Peter Matulis <peter.matulis@canonical.com>
* Update charm-deployment-guide from branch 'master'
to 4a1b9ae467ad8ae2d122eb085d94bbf03f829f61
- Merge "Make storage requirements better"
- Make storage requirements better
Lower the cloud node disk requirements from 3 to 2. This
is also in agreement with the Charm Guide golden path.
Change-Id: I65d63ee8dce90901a739ec8d8bd3f0c7b993deee
Signed-off-by: Peter Matulis <peter.matulis@canonical.com>
* Update charm-deployment-guide from branch 'master'
to 428102f9c44153b8b79824a5325aabad4feba45c
- Update for Jammy Bobcat
* Update channels for a Jammy Bobcat cloud (using 1.8 track for vault at
this time; may change to 1.10)
* Update any command output accordingly
* Add an image related to MAAS health check
* Move the dashboard section from the install page to the configure page
- users may try an operation and it will not work until configuration
is complete
* Reword the section on software sources to be leaner and clearer
* Improve some links - in particular, use charm links to default
channels in the Charmhub in order to get useful documentation
Change-Id: I86e1b2ce1d4b5bc517fe84b9149c0776660d9bcf
Signed-off-by: Peter Matulis <peter.matulis@canonical.com>
* Update charm-deployment-guide from branch 'master'
to bc4384eb88333fa1c23b754f005d418d3578d6e3
- Fix up non-admin user rc file
Add variables to non-admin user cloud rc file.
Change-Id: I6e714360b2bd0102b5381c8a2dbe05988f8f8118
Signed-off-by: Peter Matulis <peter.matulis@canonical.com>
* Update charm-deployment-guide from branch 'master'
to e97b03dd256b49b37bf4f752733cb2dc6750307f
- Update openrc for Juju3 and make it local
Like the Charm Guide Getting Started tutorial, use a local
openrc file as opposed to downloading it from the openstack-bundes
repository.
Make this openrc file support Juju 3. It's the same file
recently reviwed in a similar Charm Guide PR.
Related-To: I74315e5a64902d7e96e3557cb99d89493e62ad4c
Change-Id: I3d9b1badda3c79ea2149f5d780c7e25084fd06e2
Signed-off-by: Peter Matulis <peter.matulis@canonical.com>
* Update charm-deployment-guide from branch 'master'
to f28f3b779219ab164e08c64862b43872bf1f69f5
- Add Juju 3 support
Subsitute commands and add a pointer for Juju 2.9 users to the central
explanatory page in the Charm Guide.
The Juju version stated as being used in this guide is still of the 2.9
series. This will change when the guide is soon updated for 2023.2.
Change-Id: I807e2824ccae7f87ddb21503d35c417e89562b6e
Signed-off-by: Peter Matulis <peter.matulis@canonical.com>
* Update charm-deployment-guide from branch 'master'
to d78e6e79bf2cd0f46bbe5a12faa2febbe8998709
- Pin to Juju 2.9 for the time being
The whole guide assumes Juju 2.9 as the top page states:
> The software versions used in this guide are as follows:
> * Ubuntu 22.04 LTS (Jammy) for the Juju client, Juju controller, and
> all cloud nodes (including containers)
> * MAAS 3.3.3
> * Juju 2.9.43
> * OpenStack 2023.1 (Antelope)
Now that the default channel of Juju snap is 3.1, we should pin to 2.9
in the short term. Otherwise the first user experience is not going to
be smooth due to backward-incompatible commands such as `juju
add-relation` or `juju run`.
Closes-Bug: #2029323
Change-Id: Ia5eb711de1ef60443311413477460620de17f77d
* Update charm-deployment-guide from branch 'master'
to fc7c83f5ecdfe05207cf8d6ef71743e2104c6547
- Trivial fix for generating 2023.1 guide release
This PR will be used to generate a 2023.1 version of
this guide by a follow-up backport of it to the
newly-created 2023.1 stable branch.
Change-Id: I1ddc87821febcdf9bbce0d26b38c1cac37b302e9
* Update charm-deployment-guide from branch 'master'
to d7591029fe0bb19c47dcd84cf0bb3b7f8d20ad9c
- Update guide to 2023.1
Update Juju and MAAS versions.
Make some minor text improvements, including links to
charms.
Use channel-specific Charmhub links for charms
Change-Id: I04ab75a56f4311ffb7ec49f4627b75e5d24ef4c6
* Update charm-deployment-guide from branch 'master'
to 5de91da169c5971c8fc0db3b6c62648514696199
- Merge "Reword osd-devices option usage"
- Reword osd-devices option usage
Slightly reword the text describing how to determine the
value of the osd-devices option (ceph-osd charm).
Closes-Bug: #2008219
Change-Id: I7512d62574f60db3f415ae39757b2a158d559527
* Update charm-deployment-guide from branch 'master'
to 2a71b94bc8d437671b59dfb2e70f5b9999f1bc6a
- Improve navigational words on MAAS page
Closes-Bug: #2006480
Change-Id: I02e4f422045d8e9bcb155a953660f8292f14f2c4
* Update charm-deployment-guide from branch 'master'
to cd286d6ded5803753f85244ec7a8116d0d72c5ac
- Trivial
This trivial PR will also be used to generate an OpenStack
Zed version of the guide.
Change-Id: I47df93e8991baff76df3aeb5f8a3ec427aa2055c
* Update charm-deployment-guide from branch 'master'
to 418d689a71fcb56f65708df3dbcc98847608041a
- Remove some deprecation warnings
Remove some deprecation build warnings from this
guide.
This PR will also be used to generate an OpenStack Zed
version of the guide.
Change-Id: Ie776798f96b0de8d17a08e45e7a4d1e42b84359b
* Update charm-deployment-guide from branch 'master'
to 7a15d3a4b24ae9f12d565431d9a008f0ed6d9b21
- Update to Jammy-Zed
I was forced to use an environment different from what I
normally use, hence the changes to infrastructure values.
Also closes a bug.
Closes-Bug: #2006729
Change-Id: I5d05c7d532b3433c8c53061f8a1727ab6c81e6e9
* Update charm-deployment-guide from branch 'master'
to 289f61afc97b94e1498d925f7faac23bd7a2a976
- Up sphinx for Python 3.10 - Jammy
On Jammy hosts the docs will not build due to an
incompatibility between Sphinx and Python 3.10.
Increase Sphinx version in requirements.txt to at
least 4.2.
Change-Id: I34d9c1a6baa042535ea74758c9a4b51f97e6965a
* Update charm-deployment-guide from branch 'master'
to c4fa34d08a59c5179ec41b09ddfe574bf01f388a
- Merge "Improve software specfication text"
- Improve software specfication text
Minor improvement to wording.
Fix a hyperlink.
Change-Id: I7fd776702ae58501738dbf0e658b8e73369bbaa0
* Update charm-deployment-guide from branch 'master'
to 8c1c7642744ac09b933c0b0d28d098cb1b2a2a12
- Improve internal links
For internal links to the deploy-guide or, via intersphinx, to
the charm-guide use direct Sphinx links (instead of manual or
manual+redirected URLs).
Change-Id: I509966b2e58c7cd4e7943fbabb530d7178a93118
* Update charm-deployment-guide from branch 'master'
to 5f6fec4323a6af9ed114b03628fb0ccafb4b6c7c
- Add info re software version selection
Make it clearer how software versions are selected for
charms and for cloud services.
Closes-Bug: #1974481
Change-Id: Idcb64aa12ff7e9069d8b0cf20a008ca55ff7ac78
* Update charm-deployment-guide from branch 'master'
to 4e3919b0e3f233eb80b00bbeb80bf462da4b5e8c
- Remove bug and update versions
A Juju bug citation (and its workaround) was removed.
LP #1966664 is gnarly and is not completely resolved, but it no
longer affects this guide.
During the testing of the above updated software was used so
update the versions stated in the guide. In particular, a Jammy
Juju controller was used.
Related-Bug: #1966664
Related-Bug: #1971616
Change-Id: I0276861e672b24e0c886a64b5a04bb8e30caf45d
* Update charm-deployment-guide from branch 'master'
to 25bb3b2ffe362bc1c5037fb3007fc24a9132ce86
- Review post-migration of pages
The migration of non-deployment content to the charm-guide
is now complete. This PR is a consequence of that change. It
introduces some rewording and restructuring. In particular,
the installation-overview page is folded into the main
landing page. This PR closes a bug in the process.
Closes-Bug: #1976369
Change-Id: I5e31bd0e340662b52607bc72a089bd7c08190741
* Update charm-deployment-guide from branch 'master'
to f6da73921e53a5f491aa56773fb821a668b690d5
- Remove upgrade pages
Remove the upgrade pages as they are being migrated to
the charm-guide.
Add HTML redirects (and tests) for the more important
pages.
Depends-On: I31ecf2b885d808802fc83a0a8414032764b20e1d
Change-Id: I446a5849cee97351e21ce2435cede2a742d3a9e0
* Update charm-deployment-guide from branch 'master'
to 735f9d2e8104bf0baad4a3699279cb25e4d3faea
- Remove issues and procedures pages
Remove the issues and procedures pages as they are
being migrated to the charm-guide.
Some links need to be changed as a consequence.
Add HTML redirects (and tests) for the more important
pages. A previous redirect was only modified as it was
put into place only very recently.
Depends-On: Iba9231ba501253692acba9f059a913b54226cb5e
Change-Id: Ifd70efb85eba841dd74e8d0b453d8f63f81c16e0
* Update charm-deployment-guide from branch 'master'
to a4badb4534547978801b39a951d893eaed6acb16
- Merge "Refactor issues and procedures"
- Refactor issues and procedures
Centralise all noteworthy issues and procedures into a
single page. This will make it much simpler for users to
find important information and will reduce the necessity
to include multiple links in many pages.
Move the placement charm procedure to its own special charm
procedure page and link to it from the stein:train upgrade
path page.
The new page is currently in the Upgrades section but this
is temporary. It will soon be migrated to the charm-guide
where it will be placed under the Project section.
Include an HTML redirect (and test) for the former
upgrade-special page.
Change-Id: I3a8abe0d6b82447ca6d2883065cb1a2ce6d906b9
* Update charm-deployment-guide from branch 'master'
to 9e63c519573df200596f6617bf311e876efb00be
- Fix OVN redirect
Fix an HTML redirect that was recently put in place
for a migration of the Networking pages.
Fix a broken link for the project to build.
Change-Id: I99b0287fcb758e1ec8fac7a8f6cf31d76f500107
* Update charm-deployment-guide from branch 'master'
to 7521eb4f626987bcbff4fb0585e4598dff29f2f4
- Merge "Un-orphan pages"
- Un-orphan pages
The practice of orphaning pages should be an exception.
Doing so removes build checks (e.g. link checking).
Change-Id: I12b892ca0f558ad461435d3bb6c16e52c1d1c6e2
* Update charm-deployment-guide from branch 'master'
to 365e7576bb73f1dd9f5bb04d380bba8910124aa0
- Small improvements to upgrade overview
Also remove a hardcoded temporal reference that will soon be
out of date.
Change-Id: I2f8c78c994d1fba6eccc7ad6f2953a408afb5875
* Update charm-deployment-guide from branch 'master'
to d144e9df2e6f3859999915390440d0bd8645cc6c
- Remove security pages
Remove the Security pages as they are being migrated
to the charm-guide.
Some links need to be changed as a consequence.
Add HTML redirects (and tests).
The security overview page was completely removed
(not migrated) as its contents did not warrant a page
of its own. The little it had will be incorporated at
a later date.
Change-Id: If1bcbb39b4186fac7073f77bc0dacdac4294d3ff
* Update charm-deployment-guide from branch 'master'
to 52849548d6f55ab99e12e75cf183c5c11dadb9cf
- Remove networking pages
Remove the Networking pages as they are being migrated
to the charm-guide.
Some links need to be changed as a consequence.
Add HTML redirects (and tests).
Depends-On: I39304470b71742a6cf01aa04cd80e2c2de1cdf9f
Change-Id: Ibc9db2ac43c24f9568d0a2446907ba517856a2df
* Update charm-deployment-guide from branch 'master'
to 41823a465140e47e1d0806de70b0587351c7cced
- Merge "Move OVN migration to special operation"
- Move OVN migration to special operation
The OVN documentation requires refactoring.
The first step is to feature the ML2+OVS to ML2+OVN
migration as a special charm procedure.
The change is a strict move (not a review) with the
exception of some link and header management and an
introductory paragraph for the new page.
Change-Id: I3ba6111364bc7703b50cb21f1c0e25e2cafaa8e3
* Update charm-deployment-guide from branch 'master'
to 58862a5f9688b5df10b2f77ee745a01f1773b738
- Spelling mistakes fix
The current master branch has a couple of spelling mistakes.
This commit includes the correction to the following doc:
charm-deployment-guide/deploy-guide/source/app-certificate-management.rst
'Notably' was misspelled as 'Notebly'.
'Existing' was misspelled as 'Exisitng.
Change-Id: I9f46b1d498815bf557c050c24ffee846ae39f706
* Update charm-deployment-guide from branch 'master'
to 77f4b9ea5b5547156598ea598bda3097d016a500
- Merge "Mention hardware addresses for OVN Chassis"
- Mention hardware addresses for OVN Chassis
It is common for users to not have the same
network interface name available across all MAAS
nodes for ovn-chassis units. This PR outlines the
use of hardware addresses.
Change-Id: I84cc572441f55c5e38f4bb99613be2514bddd86a
* Update charm-deployment-guide from branch 'master'
to b9beb8882d01c99c34e8981b73b4964b0d4f53b8
- Merge "Add guide for switching between different types of certificates"
- Add guide for switching between different types of certificates
Add the steps for swtiching between self-signed CA certificate
and third-party intermediate CA certificate after Vault charm
deployment. A note asking user to check the level of authorization
of the intermediate CA certificate is also added.
Closes-Bug: #1913289
Change-Id: I9e8ca51759650d211f491457cb0d0fc0040358e8
* Update charm-deployment-guide from branch 'master'
to 5920c9ffab2c73e07c9515951a1dff60c2c739d9
- Add intersphinx Sphinx extension
Add the intersphinx Sphinx extension to enable seamless
linking from the charm-guide.
This is already enabled for the charm-guide - for seamless
linking from this guide (deploy-guide).
Change-Id: I36442bfc8ff9267786cce87b32dfff2348c30f57
* Update charm-deployment-guide from branch 'master'
to ebcf952ef9727cf8ab03832f35a54073b30a9208
- Merge "Add dedicated OpenStack upgrade path pages"
- Add dedicated OpenStack upgrade path pages
Add dedicated OpenStack upgrade migration path pages to
make it clearer for upgraders. Doing so also removes
non-relevant text from the general upgrade-issues page.
Add a redirect to account for the deleted placement
charm special procedure page.
Closes-Bug: #1970272
Change-Id: Ibd09e9e0d66a6f9e152f37c6ac675eed35c97bde
* Update charm-deployment-guide from branch 'master'
to b5a14a38904067eea56910a0b9867dc9928bddaa
- Merge "Improve the special charm procedures page"
- Improve the special charm procedures page
Improve wording on the special charm procedures page
(it currently is at odds with channeled charms) and
streamline the reference back to the rest of the
upgrade pages.
Change-Id: I4f39e75fdda968a280f230283cf3ea41d7397c51
* Update charm-deployment-guide from branch 'master'
to 8707712087faa4a995d9c8dbb95b7b93463bb927
- Improve upgrade overview
Improve and streamline upgrade overview text.
In particular, move the topology information to the
upgrade-overview page.
Related-Bug: #1929091
Change-Id: If8bb494966915c34f50a23937f3b500ed99c7049
* Update charm-deployment-guide from branch 'master'
to 70a2ebe80fe59e69f15852e55a09c7eaf24a73e2
- Remove storage pages
Remove the storage pages as they are being migrated
to the charm-guide.
Add HTML redirects (and tests) as a consequence.
Depends-On: I933916e1a77e108ec255289e562149240ba09470
Change-Id: I20ffd8b97cfdac37ce83dc9fab35be236999e1e5
* Update charm-deployment-guide from branch 'master'
to e6c366f6bd3155fa6ba133f8c24a0060312c2db0
- Merge "Remove compute pages"
- Remove compute pages
Remove the Compute pages as they are being migrated
to the charm-guide.
Add HTML redirects (and tests) as a consequence.
Change-Id: Idf777582fcb902dcd1f603d04c8f872c579460ff
* Update charm-deployment-guide from branch 'master'
to 53bbeb7b860a9ad3b300bd5d9f0b18852ae981a4
- Merge "Modifications pursuant to golden path tutorial"
- Modifications pursuant to golden path tutorial
Now that the golden path tutorial has received
sufficient polish, this PR makes modifications to the
Deploy Guide accordingly.
* Point to the tutorial and remove the
install-openstack-bundle page.
* Reword, refactor, and deal with a link.
Change-Id: I90fd395c1a31d3e59f480a8dd0bb8fcf58915e83
* Update charm-deployment-guide from branch 'master'
to 1fb631fbf96c9225943b5ca4b74f4877e8bce476
- Trivial formatting + guide version
Improve formatting for an unordered list on the
OVN page.
This PR will also be used to generate an OpenStack
Yoga version of charm-deployment-guide.
Change-Id: I8f24579ad202129e76b05e84a6a3aee780517b6d
* Update charm-deployment-guide from branch 'master'
to 4dd158584363032061831ad263441044c4e604a5
- Fix a broken link + guide version
There is a broken link on the upgrade-charms page due
to upstream Juju doc changes.
This PR will also be used to generate an OpenStack
Yoga version of charm-deployment-guide.
Change-Id: Ibe1f8041c1e5a8175fb63d638cc81b0987ed6eba
* Update charm-deployment-guide from branch 'master'
to 2fa962231e708e1f502c24a62733259d5160ffd0
- Merge "Update guide to Jammy Yoga"
- Update guide to Jammy Yoga
Update the install instructions to Jammy Yoga.
Remove the worker-multiplier option for containerised
services as this leads to too many processes on highly
resourced machines. There is already a default maximum
number of four.
Instructions have been tested and verified. At the time
of writing:
* placement charm needed to be installed by force
* ntp charm was not available for Jammy
Change-Id: I7282604f416ac7bf3b3ebfb6b9cd5ed257847b66
* Update charm-deployment-guide from branch 'master'
to 43424cb48fdf8b3e5b5a2074779521aba219a087
- Remove Masakari page
Remove page 'app-masakari' as it is being migrated
to the charm-guide.
Add an HTML redirect (and test) as a consequence.
Depends-On: I23547bee5239b0f2075042c9b799d0c060bd3de2
Change-Id: Ia7dc6e2f12035e824310cabdaa93663a69ddeb30
* Update charm-deployment-guide from branch 'master'
to c5d113382d2b84fcc77f9dd3ae6de81e9485a354
- Merge "Remove Trilio page"
- Remove Trilio page
Remove page 'app-trilio-vault' as it is being migrated
to the charm-guide.
Add an HTML redirect (and test) as a consequence.
Drive-by: Remove the convenience link stating that cloud
operations have moved. It has been there for one release.
Depends-On: I48df4c1ce1e41fd8625d1bb0891d52b3a098f911
Change-Id: Ie41a79fa8973c40319e5ac85cb871381e7d3a62a
* Update charm-deployment-guide from branch 'master'
to 35fe31ae5fdde367bf35f9154f6bfa2a6c30e5f5
- Merge "Improve charm upgrade text"
- Improve charm upgrade text
Improve charm upgrade text in a few files.
Change-Id: I95b5a38b71dadf6ce398f9a1fb2757d7921fbef0
* Update charm-deployment-guide from branch 'master'
to a0e68390b6be1130dcf5bdd191d8317cde87bb30
- Merge "Add two known issues"
- Add two known issues
Add two known issues to the various-issues page.
Change-Id: Idd4383752ebbb6a2463440ba768e4292e841024d
* Update charm-deployment-guide from branch 'master'
to 20a42b606884030e830bf7872b3757e0e766d33a
- Update Hardware Offload section
This cycles validation work has changed the classification of the
feature as well as hardware and software requirements.
Change-Id: Ib7f5ed930623a777beca20728fa19e04d5306f76
* Update charm-deployment-guide from branch 'master'
to b4d4a36160ca5da04726224247927e0e78e1b9fc
- Improve Placement special operation
Improve the instructions that cover the introduction of the
placement charm by mentioning that nova-compute payload
upgrade should follow nova-cloud-controller payload upgrade.
Correct the payload upgrade order on the openstack-upgrade
page by putting nova-compute after nova-cloud-controller.
The former was recently moved up due to minimise OVN control
plane downtime but the current fix is essential.
The upgrdae-charms page was likewise updated.
Closes-Bug: #1970266
Change-Id: Ic564bfd649bd8d3ba435577b7e7d2f472992a1c6
* Update charm-deployment-guide from branch 'master'
to d1e905f16014b82e8ecaac278927f05d836ada7f
- Merge "Accomodate Charmhub channels in upgrade pages"
- Accomodate Charmhub channels in upgrade pages
Introduce changes across all upgrade pages to
accomodate for charm channels.
Removed the method for determining charm revision
update candidate as there is no reasonable way to
do this with the legacy charm stream.
Drive-by: Remove unused file (enable-merge)
Depends-On: Ia3ebfad4a6aa43620cad188b07ec6fc7a29b71a7
Change-Id: I7ea4eae65cc55c3a7081a505dd9bad34852dc8c3