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

101 Commits

Author SHA1 Message Date
Pierre Prinetti
0e2b614de4 openstack: Document Image Registry migration to Swift 2022-12-22 15:44:48 +01:00
Pierre Prinetti
f8bf57d171 Update OpenStack spec dependencies
The the OpenStack providerSpec for Machine has been moved to
openshift/api.
2022-11-11 11:33:50 +01: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
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
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
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
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
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
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
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
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
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
Emilio Garcia
b63ca8915e Create OpenStack Documentation for MachineSets with Multiple Networks
Due to the addition of the PrimarySubnets variable in the providerSpec
we wanted to ensure that users knew it existed and of its pitfalls.

Fixes: OSASINFRA-2088
2020-12-15 15:32:02 -05:00
Emilien Macchi
97d4a549e1 openstack: check quotas before creating cluster
Note: openshift-installer already check quotas for AWS and GCP.

1) Calculate the quota constraints based on the InstallConfig.
   For both ControlPlane and workers, get the flavors and
   create a list of quota resources that will be needed to
   successfully deploy the cluster.
   Note: for now, only instances, CPUs and RAM are supported.
   In the future, we'll add networking and storage resources.

2) Fetch project quotas by using OpenStack API (via gophercloud)
   and create the constraints (for instances, CPUs and RAM only
   for now).
   The Quota constraints will be stored in the CloudInfo struct,
   for caching so we avoid multiple calls to the OpenStack APIs
   to get quotas.

3) The logging is improved when there is no region name for
   a cloud provider.

bz#1690924
jira https://issues.redhat.com/browse/OSASINFRA-1141

Co-Authored-By: Matthew Booth <mbooth@redhat.com>
Signed-off-by: Emilien Macchi <emilien@redhat.com>
2020-12-04 17:05:40 -05:00
Emilio Garcia
30e597f4c6 OSASINFRA-902: Update OpenStack Custom External LB and DNS Docs
The underlying network architecture has changed a lot since these docs
were initially written. We want to make sure that these docs are accurate
and up to date so that users with complex networking use cases like workers
on a custom subnet and baremetal workers are able to manage their ingress/egress
traffic as needed. More up to date examples and reference information has been added.

We have chosen to omit sections outlining how to replace the internal lb and dns
services since they were inaccurate. We are targeting an upcoming release to handle
these features better given the complexity of our current networking architecture.
2020-11-30 15:30:29 -05:00
Emilien Macchi
1b400b48f8 openstack: consider volumes for storage requirements checks
It is possible to boot a server without using ephemeral storage, with
boot from volume:
https://docs.openstack.org/cinder/latest/admin/blockstorage-boot-from-volume.html

This patch will disable flavor storage check if rootVolume is used in
the Machine Pool and checks that the volume is at least 25Gb sized.

https://bugzilla.redhat.com/show_bug.cgi?id=1891543

Signed-off-by: Emilien Macchi <emilien@redhat.com>
2020-11-03 09:18:51 -05:00
Emilien Macchi
bf3fbbb56f openstack: fixup markdown
Some titles were missing, this patch was generated by my IDE (vscode)
with Markdown plugin installed.
2020-10-30 11:23:05 -04:00
Pierre Prinetti
71b1c39db2 openstack: Document Cinder's ignore-volume-az 2020-10-15 14:58:49 +02:00
OpenShift Merge Robot
e30be37bf0 Merge pull request #4214 from iamemilio/permissions_docs_openstack
openstack privileges documented
2020-10-08 10:56:08 -04:00
Emilio Garcia
ce23427f95 openstack privileges documented 2020-10-08 10:38:06 -04:00
Mike Fedosin
712799df0d Rename lbFloatingIP to apiFloatingIP 2020-10-07 18:15:48 +02:00
OpenShift Merge Robot
2876582719 Merge pull request #4059 from mandre/ingress-fip-doc
Bug 1877676: OpenStack: Refresh documentation about ingress FIP
2020-09-11 08:56:32 -04:00
Martin André
d9bd956462 OpenStack: Refresh documentation about ingress FIP
Since https://github.com/openshift/installer/pull/3855, the installer is
able to attach the `ingressFloatingIP` specified in the
`install-config.yaml` to the ingress-port. Update the documentation to
reflect the change.
2020-09-11 14:48:04 +02:00
Luis Tomas Bolivar
250d7a7a1c Add information about AZs limitations with Kuryr 2020-08-28 14:37:58 +02:00
Pierre Prinetti
4597a12ca3 openstack: Document MachineSet availabilityZone 2020-08-20 12:09:22 +02:00
Pierre Prinetti
23578bb14e openstack: Known issue: no BMs on Kuryr 2020-08-18 11:34:54 +02:00
OpenShift Merge Robot
8c1d408057 Merge pull request #4016 from shiftstack/os_document_compute_server_group
OpenStack: Document the MachineSet resource
2020-08-11 13:38:08 -04:00
W. Trevor King
41d7bf7417 docs/user/openstack: Replace try.openshift.com with www.openshift.com/try
Respecting the 301 redirects currently in place:

  $ curl -sLi https://try.openshift.com | grep -i '^http\|^location'
  HTTP/1.1 301 Moved Permanently
  location: https://www.openshift.com/try/
  HTTP/1.1 301 Moved Permanently
  Location: https://www.openshift.com/try
  HTTP/1.1 200 OK

From the spec for 301 redirects [1]:

  The 301 (Moved Permanently) status code indicates that the target
  resource has been assigned a new permanent URI and any future
  references to this resource ought to use one of the enclosed URIs.

So we should no longer be using the outdated URI.

[1]: https://tools.ietf.org/html/rfc7231#section-6.4.2
2020-08-08 14:16:27 -07:00
Pierre Prinetti
cdbdf51cc3 OpenStack: Document the MachineSet resource
Add an example MachineSet with the OpenStack platform-specific
properties.
2020-08-07 12:02:06 +02:00
Pierre Prinetti
9e9bbcc363 openstack: Add numbers to disk requirements
Before this documentation change, there was no clear indication of the
expected disk latency in the OpenStack requirements.

The threshold value (10ms) is taken from a post[1] on the IBM Cloud blog,
which the official ETCD documentation points to.

[1]: https://www.ibm.com/cloud/blog/using-fio-to-tell-whether-your-storage-is-fast-enough-for-etcd
2020-05-27 14:44:02 +02:00
Pierre Prinetti
aa5df67828 os: Fix wait-for install-complete timeout in docs 2020-05-12 12:09:43 +02:00
Pierre Prinetti
689872c4ba Bug 1814605: openstack: Require three workers
Prior to this change, the documentation refers to working clusters with
two workers. As of 4.5, two workers of 2vCPUs are not enough for a
healthy cluster.
2020-05-06 09:51:16 +02:00
Pierre Prinetti
c9bcfa131a openstack docs: Add tagging as a requirement
For a successful installation, it is required to be able to tag network
resources.
2020-04-29 12:57:41 +02:00
OpenShift Merge Robot
35bc7b70d2 Merge pull request #3447 from shiftstack/os_require_servergroup
openstack: Mention Server group requirement
2020-04-17 22:13:50 -04:00
Emilio Garcia
cae6c6d191 Correcting the instructions to refresh a CA cert 2020-04-15 10:57:01 -04:00
Pierre Prinetti
208c777794 openstack: Mention Server group requirement
A Server group will be created during the installation on OpenStack.
2020-04-14 09:39:46 +02:00
Pierre Prinetti
cfc6f92fce Bug 1823659: os: Mention the bootstrap FIP
In order for the user to account for the needed resources, the
documentation should mention that while 2 floating IPs are needed for
running an OpenShift cluster, a third one will be used during
installation.
2020-04-14 09:31:52 +02:00
Pierre Prinetti
96e381d3a2 openstack: Detail the clouds.yaml cacert option
The documentation was not clear as to where the path for "cacert" was
relative to.
2020-03-27 11:33:43 +01:00
Pierre Prinetti
144afef3da openstack: soft-anti-affinity policy for CP
This places the Control Plane servers in a Server Group that enforces
"soft anti-affinity" policy.

"Soft anti-affinity" will cause Nova to create VMs on separate hosts, if
that is possible.

Implements OSASINFRA-1300
2020-03-18 17:50:39 +01:00
OpenShift Merge Robot
a627412646 Merge pull request #3091 from iamemilio/ssc-day2-docs
Bug 1801799: openstack docs day 2 ssc refresh
2020-02-14 17:19:13 +01:00
Emilio Garcia
ba03b4e937 day 2 ssc refresh 2020-02-13 16:00:47 -05:00
OpenShift Merge Robot
92bdcb3b4e Merge pull request #3011 from shiftstack/OSASINFRA-1108
Bug 1802035: openstack UPI: Document Ansible
2020-02-12 11:41:25 +01:00
Emilio Garcia
88d8723e62 self signed certs docs 2020-01-31 11:07:03 -05:00