Skip to content

Swiftless ShiftStack installation - OSDOCS923 #20420

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
maxwelldb merged 1 commit into from
Apr 14, 2020
Merged

Swiftless ShiftStack installation - OSDOCS923 #20420

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion installing/installing_openstack/installing-openstack-installer-custom.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ In {product-title} version {product-version}, you can install a customized clust
xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update]
processes.

* Have access to a {rh-openstack} administrator's account
* Have a storage service installed in {rh-openstack}, like Block Storage (Cinder) or Object Storage (Swift). Object storage is the recommended storage technology for {product-title} registry cluster deployment. For more information, see xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].

* Have metadata service enabled in {rh-openstack}

Expand Down
2 changes: 1 addition & 1 deletion installing/installing_openstack/installing-openstack-installer-kuryr.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ In {product-title} version {product-version}, you can install a customized clust
xref:../../architecture/architecture-installation.adoc#architecture-installation[{product-title} installation and update]
processes.

* Have access to an {rh-openstack} administrator's account
* Have a storage service installed in {rh-openstack}, like Block Storage (Cinder) or Object Storage (Swift). Object storage is the recommended storage technology for {product-title} registry cluster deployment. For more information, see xref:../../scalability_and_performance/optimizing-storage.adoc#optimizing-storage[Optimizing storage].

[IMPORTANT]
====
Expand Down
13 changes: 6 additions & 7 deletions modules/installation-osp-default-deployment.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,20 +22,19 @@ Your quota must meet the following requirements to run the {product-title} insta
|Subnets | 1
|RAM | 112 GB
|vCPUs | 28
|Volume storage | 175 GB
|Volume storage | 275 GB
|Instances | 7
|Security groups | 3
|Security group rules | 60
|Swift containers | 2
|Swift objects | 1
|Swift available space | 10 MB or more
|================================

[NOTE]
Swift space requirements vary depending on the size of the bootstrap Ignition file and image registry.

A cluster might function with fewer than recommended resources, but its performance is not guaranteed.

[IMPORTANT]
====
If OpenStack Object Storage (Swift) is available and operated by a user account with the `swiftoperator` role, it is used as the default backend for the {product-title} image registry. In this case, the volume storage requirement is 175GB. Swift space requirements vary depending on the size of the image registry.
====

[NOTE]
By default, your security group and security group rule quotas might be low. If you encounter problems, run `openstack quota set --secgroups 3 --secgroup-rules 60 <project>` to increase them.

Expand Down
16 changes: 11 additions & 5 deletions modules/installation-osp-enabling-swift.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,20 @@
[id="installation-osp-enabling-swift_{context}"]
= Enabling Swift on OpenStack

{product-title} on {rh-openstack-first} uses https://docs.openstack.org/security-guide/object-storage.html[OpenStack Object Storage (Swift)] to store and serve user configuration files.
Swift is operated by a user account with the `swiftoperator` role. Add the role to an account before you run the installation program.

Swift is operated by a user account with the `swiftoperator` role.
[IMPORTANT]
====
If link:https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.0/html-single/storage_guide/index#ch-manage-containers[OpenStack Object Storage (Swift)] is available, {product-title} on {rh-openstack-first} uses it as the image registry storage. If it is unavailable, the installation program relies on the OpenStack Block Storage service (Cinder).

If Swift is present and you want to use it, you must enable access to it. If it is not present, or if you do not want to use it, skip this section.
====

.Prerequisites

* A {rh-openstack} administrator account on the target environment
* On Ceph RGW, https://docs.ceph.com/docs/master/radosgw/config-ref/#swift-settings[the `account in url` option must be enabled]
* You have a {rh-openstack} administrator account on the target environment.
* The Swift service is installed.
* On link:https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.0/html-single/deploying_an_overcloud_with_containerized_red_hat_ceph/index#ceph-rgw[Ceph RGW], the `account in url` option is enabled.

.Procedure

Expand All @@ -26,4 +32,4 @@ To enable Swift on {rh-openstack}:
$ openstack role add --user <user> --project <project> swiftoperator
----

Your {rh-openstack} deployment can now use Swift to store and serve files.
Your {rh-openstack} deployment can now use Swift for the image registry.