1
0
mirror of https://github.com/openshift/installer.git synced 2026-02-06 09:47:02 +01:00
Commit Graph

270 Commits

Author SHA1 Message Date
Michał Dulko
2af3ae5524 OpenStack: Update Kuryr storage requirements 2022-08-31 12:06:52 +02:00
Michał Dulko
4e4b17a8a8 OpenStack: Set minimum disk of a flavor to 100 GB
Other platforms require at least 100 GB of disk size and we've updated
openshift-docs to reflect that in OpenStack too. Seems like we forgot to
update flavor validation code and docs in the installer. This commit
fixes this.
2022-08-30 10:33:17 +02:00
Jamo Luhrsen
74486c10c6 Change defaultNetworkType to ovn-kubernetes
In 4.12, the default CNI will be OVNKubernetes.
This change will deploy ovnk by default as well
as adjust tests, docs and comments to reflect
the same.

Signed-off-by: Jamo Luhrsen <jluhrsen@gmail.com>
2022-07-28 22:26:08 -07:00
Pierre Prinetti
701abd8b10 openstack UPI: Remove Swift example, use Glance
The UPI workflow needs the bootstrap ignition file to be hosted
somewhere. Prior to this patch, the first proposed example used Swift.
However, the example was using commands that are not available in the
openstack client shipped with the recommended operating systems and
repositories.

This patch removes the Swift example and focuses the workflow on using
Glance instead, along the lines of what the IPI installer does. The UPI
docs still mention that any hosting system can be used, including Swift.
2022-07-07 10:16:31 +02:00
Pierre Prinetti
1c175f709c openstack UPI: clarify naming of RHCOS image
This patch adds:
* explanation on how the name of the RHCOS image on Glance must match
  the content of inventory.yaml;
* instructions for removing the image after use.
* a scripted unique name for the RHCOS image in Glance, so that the UPI
  tests can be run in parallael.
2022-07-05 16:35:38 +02:00
Pierre Prinetti
0a63c1d356 openstack: Prepare for a UPI CI job
With this patch, the documentation for installing on OpenStack with UPI
is made machine-readable.

Additionally, UPI resources are added to the CI container image.
2022-06-29 10:16:59 +02:00
Pierre Prinetti
a78d148c6e openstack UPI: Minor fixes
* Fix the remote RHCOS image name
* Replaced some grammar mishaps with fresher ones
2022-06-29 10:16:58 +02:00
openshift-ci[bot]
6daed68b98 Merge pull request #6018 from danwinship/kubeconfig-command-copyability
Bug 2100841: Print the "export KUBECONFIG=..." command on its own line for easier cut-and-paste
2022-06-24 15:34:42 +00:00
Maysa Macedo
cbb511557b Bug 1997704: [OpenStack]Document limitation for external LBs
By default, the cloud provider does not support creation of FIPs
using pre-defined addresses due to a policy that allows this operation
only for admins. This commit updates the documentation with possible
solutions for this issue.

Co-authored-by: Martin André <martin.andre@gmail.com>
Co-authored-by: Max Bridges <50179998+maxwelldb@users.noreply.github.com>
2022-06-24 11:16:36 +02:00
Dan Winship
68f22f89ed Print the "export KUBECONFIG=..." command on its own line for easier cut-and-paste 2022-06-16 10:54:28 -04:00
Stephen Finucane
eafb73317d Bug 1969794: Correct typo
The created pvc needs to use a volumeMode of 'Filesystem', not 'Block'.
Using the latter will result in the image-registry pod failing to mount
the volume because it can't handle raw block devices without a
filesystem [1].

[1] https://docs.openshift.com/container-platform/4.10/virt/virtual_machines/virtual_disks/virt-creating-data-volumes.html

Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
2022-05-17 17:23:05 +01:00
Emilien Macchi
91eabdd494 openstack: add doc for OVS HW offload
* doc for OVS HW offload
* add a link in README for OVS DPDK
2022-05-12 11:46:16 -04:00
Martin André
fb014f8aec OpenStack: fix SR-IOV documentation TOC 2022-05-10 10:44:03 +02:00
Emilien Macchi
d7064a505c Update SR-IOV & DPDK doc for OpenStack
In 4.11, we did the following:

* Remove the dependency on config-drive and support OpenStack Metadata
  URL fetching.
* Automate the configuration of VFIO NO IOMMU
* Add support for vhostuser interfaces for DPDK

This patch adds more content for DPDK, with an example of a pod using
hugepages, dedicated CPUs and the DPDK port.

It also add more content for SR-IOV, like how to create a policy & a
pod.

Later, we'll add content for SR-IOV with HW offload.
2022-05-06 12:11:57 -04:00
Pierre Prinetti
e8c1284240 openstack: Migration script should --force drain
Before this patch, the migration would sometimes fail with the following
error:

```
cannot delete Pods not managed by ReplicationController, ReplicaSet,
Job, DaemonSet or StatefulSet (use --force to override)
```
2022-02-07 11:03:34 +01:00
Pierre Prinetti
f292bcc108 openstack: Fix invalid-https-certificate detection
Fix the reference to an unbound variable; avoid incrementing the invalid
certificate counter in a subshell.
2022-01-25 09:31:25 +01:00
Pierre Prinetti
32afc66b94 openstack: Document legacy HTTPS cert validation
Provide a script to validate the OpenStack endpoints, to be run before
installing or upgrading to OpenShift v4.10.
2022-01-18 10:43:31 +01:00
Adolfo Duarte
a8eddecb37 OpenStack: Instruction on how to deploy on ovs-dpk
- Describe how to deploy cluster onto ovs-dpdk enbled OpenStack
- Describe how to bind the vfi-pci kernel module
- Describe how to configure the host-device network

Co-Authored-By: Adolfo Duarte <adduarte@redhat.com>
Co-Authored-By: Emilien Macchi <emilien@redhat.com>
Co-Authored-By: Stephen Finucane <stephenfin@redhat.com>
2021-12-14 11:08:57 -05:00
Pierre Prinetti
39da0917e9 openstack: Document Control plane node migration
Provide an example script.

The script is a combination of:
* [OpenStack node migration][1]
* [OpenShift graceful node reboot][2]

Implements OSASINFRA-2508

[1]: https://docs.openstack.org/nova/latest/admin/migration.html
[2]: https://docs.openshift.com/container-platform/4.9/nodes/nodes/nodes-nodes-rebooting.html#nodes-nodes-rebooting-gracefully_nodes-nodes-rebooting
2021-12-13 14:57:34 +01:00
Pierre Prinetti
5c51a779e2 openstack: Document credential rotation
Implements OSASINFRA-2380
2021-12-10 17:47:39 +01:00
Vladimir Belousov
51a40345a7 docs: correct spelling in docs
Correct spelling to improve the readability of the documentation
2021-11-01 09:54:42 +03:00
Pierre Prinetti
8edaf43bd8 openstack: Update affinity docs
Documentation on how to manually set the Server group in the MachineSet
manifests at install-time is no longer necessary, since the introduction
of the `serverGroupPolicy` property in the OpenStack platform section of
install-config's machine-pools.

Co-authored-by: Max Bridges <50179998+maxwelldb@users.noreply.github.com>
2021-10-06 23:07:40 +02:00
Pierre Prinetti
f6dbeccc70 openstack: Expose worker server group policy
With this change, Compute nodes within each MachineSet are automatically
created in a Server group, with a default policy of
"soft-anti-affinity".

With this change, a "serverGroupPolicy" can be set in install-config, on
the worker MachinePool and/or in the platform default.

Implements OSASINFRA-2570

Co-Authored-By: Matthew Booth <mbooth@redhat.com>
2021-10-04 18:05:15 +02:00
Martin André
b9582a4636 OpenStack: Fix links in SR-IOV workers doc
The syntax for reference links in markdown was incorrect and generated
broken links.
2021-09-09 09:54:29 +02:00
Michał Dulko
df0cd0b66b Add documentation on setting cloud provider opts
In 4.9 we introduce support for LoadBalancer services. This means that
user might need to tweak the cloud provider options to match their
OpenStack cluster configuration. This commit adds documentation on how
to do it before and after the installation.
2021-07-20 17:02:58 +02:00
Mike Fedosin
258a7bc307 Bug 1969794: Document how to use image registry with a custom PVC backend 2021-07-13 11:40:13 +02:00
OpenShift Merge Robot
c390846c13 Merge pull request #4979 from Fedosin/image_registry_domain
Bug 1969374: document how to update domain for image registry in versions <4.8
2021-07-13 04:32:20 -04:00
OpenShift Merge Robot
4361279d80 Merge pull request #5003 from shiftstack/openstack_master_antiaffinity
openstack: Expose master server group policy
2021-07-03 12:42:04 -04:00
Pierre Prinetti
4a5b29ced0 openstack: Expose master server group policy
Prior to this change, the Control plane nodes are created in a server
group with the hardcoded policy "soft-anti-affinity".

This change adds a new configuration knob in the OpenStack-specific
MachinePool configuration of `install-config.yaml`.

The new property `controlPlane.platform.openstack.serverGroupPolicy`
defines the policy that will be applied to the Control Plane server
group.

Acceptable values are:

* `affinity`
* `anti-affinity`
* `soft-affinity`
* `soft-anti-affinity`

Defaults to `soft-anti-affinity`, to match the previous hardcoded
behaviour.

Validation will fail if the property is set on the Compute MachinePool.
2021-06-28 15:02:30 +02:00
OpenShift Merge Robot
d5a0486be7 Merge pull request #4803 from Fedosin/manila_shares
Bug 1929136: OpenStack: document Manila share mounting
2021-06-16 08:51:15 -04:00
Mike Fedosin
bf978a1cd6 Bug 1929136: OpenStack: document Manila share mounting 2021-06-16 10:30:53 +02:00
OpenShift Merge Robot
0072c66be5 Merge pull request #4833 from shiftstack/edge/swift
doc/openstack: add a note about image registry in AZ
2021-06-14 10:49:17 -04:00
OpenShift Merge Robot
b37dc092db Merge pull request #4958 from iamemilio/sriov_portsec_special_case
Bug 1970415: Document SR-IOV use case: using network with port security disabled
2021-06-10 09:02:14 -04:00
Emilio Garcia
29f36016e8 Document SR-IOV use case: using network with port security disabled
This use case requires a unique usage pattern in comparison to what the
customer may be use to, so we chose to document it in its entirety to
avoid any confusion down the line.
2021-06-09 09:41:59 -04:00
Mike Fedosin
097dba1431 Bug 1969374: document how to update domain for image registry in versions <4.8
/label platform/openstack
2021-06-08 12:15:56 +02:00
OpenShift Merge Robot
873a8842a7 Merge pull request #4821 from shiftstack/mdns-removal
Bug 1946506: Bootstrap no longer relies on mdns
2021-05-28 12:01:41 +02:00
Emilien Macchi
8b226d1331 Bug 1951713: docs/openstack/known-issues: add section for machine spec edits
This patch adds a documented known issue where we explain that we can't
edit a machine spec or it'll lead to problems like the servers being
removed.
We also give a tested resolution procedure.

More info: https://access.redhat.com/solutions/5998451
2021-05-26 10:24:15 -04:00
Adolfo Duarte
13447cfa7c Bug 1954873: CoreOS only supports three dns namservers
Documentation of this limitation under the externalDNS entry.
2021-05-17 13:48:25 -07:00
Martin André
23e5ef2669 OpenStack: Remove known issue about mdns and long cluster names
We're validating the cluster name size and there's no need to document
this as a known issue, especially with mDNS going away.

We might loosen the cluster name length restriction in the future.
2021-05-14 11:42:20 +02:00
Emilio Garcia
63b7dad62b Upgrading the upstream docs to match the feedback and changes that Aaron, Itzig, and Max are adding to the downstream 4.7 release version:
explains a full end to end workflow
    example of how to create SRIOV workers in UPI
    example of how to create SRIOV workers in IPI

Fixes: OSASINFRA-2281
2021-05-03 14:44:21 -04:00
Emilien Macchi
19ac9651f5 doc/openstack: add a note about image registry in AZ
Add a note that if we deploy a cluster in an OpenStack AZ, it's
suggested to use Cinder backend if the service is available in this AZ,
since Cinder is topology aware.
Swift isn't deployed in AZs usually, so traffic would have to go
through the link between sites, which isn't optimal in real world.

Signed-off-by: Emilien Macchi <emilien@redhat.com>
2021-04-13 20:43:39 -04:00
Mike Fedosin
b6f737da91 OpenStack: Update docs for root volume availability zones 2021-04-08 13:58:49 +02:00
Colin Walters
b64d699a13 Add stream metadata for RHCOS
This implements part of the plan from:
https://github.com/openshift/os/issues/477

When we originally added the pinned RHCOS metadata `rhcos.json`
to the installer, we also changed the coreos-assembler `meta.json`
format into an arbitrary new format in the name of some cleanups.
In retrospect, this was a big mistake because we now have two
formats.

Then Fedora CoreOS appeared and added streams JSON as a public API.

We decided to unify on streams metadata; there's now a published
Go library for it: https://github.com/coreos/stream-metadata-go

Among other benefits, it is a single file that supports multiple
architectures.

UPI installs should now use stream metadata, particularly
to find public cloud images.  This is exposed via a new
`openshift-install coreos print-stream-json` command.

This is an important preparatory step for exposing this via
`oc` as well as having something in the cluster update to
it.

HOWEVER as a (really hopefully temporary) hack, we *duplicate*
the metadata so that IPI installs use the new stream format,
and UPI CI jobs can still use the old format (with different RHCOS versions).

We will port the UPI docs and CI jobs after this merges.

Co-authored-by: Matthew Staebler <staebler@redhat.com>
2021-03-24 18:21:26 +00:00
OpenShift Merge Robot
5379519a0b Merge pull request #4649 from MaysaMacedo/know-issue-upi-kuryr
Add docs about issues on UPI with Kuryr
2021-03-12 10:56:27 -05:00
OpenShift Merge Robot
84f8e473d7 Merge pull request #4691 from marun/remove-etcd-assets
Transition responsibility for CEO asset creation and placement
2021-03-10 19:07:48 +01:00
Maru Newby
2f9024146f Stop generating etcd manifests and key material
Responsibility for generating assets for etcd has been transitioned to
the etcd operator, which will render the necessary resources as part
of bootstrap.

Supporting CEO PRs:

https://github.com/openshift/cluster-etcd-operator/pull/546
https://github.com/openshift/cluster-etcd-operator/pull/549
2021-03-04 11:50:34 -08:00
Pierre Prinetti
d37b8f9eb3 openstack: Document setting affinity for workers 2021-03-04 09:20:35 +01:00
Emilien Macchi
c6977d5001 doc: openstack/IPI - Provider Networks
This is a first iteration of documenting how to deploy OCP clusters on
provider networks and all the gotchas.

Signed-off-by: Emilien Macchi <emilien@redhat.com>
2021-03-01 11:25:54 -05:00
Maysa Macedo
5b5d85522e Add docs about issues on UPI with Kuryr
Installations with Kuryr can timeout because of
recent changes on the way the nodes' subnet is retrieved.
This commit adds a section to the know issues describing
why the issue occour and how to avoid it.
2021-02-25 15:26:05 -03:00
Pierre Prinetti
d597c8440a openstack: cacert does not require system trust
With 9314e6dc5823690a08109acd26583c517912f55d, the Installer reads the
`clouds.yaml` `cacert` file to connect to the OpenStack API. It is
therefore no longer necessary to add the certificate to the system
trust.
2021-02-11 22:59:27 +01:00