Skip to content

Add pages for new OpenShift on OpenStack provider #6020

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
sdodson merged 4 commits into from
Dec 4, 2017
Merged

Add pages for new OpenShift on OpenStack provider #6020

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
33e8b58
Add pages for new OpenShift on OpenStack provider
bogdando Oct 30, 2017
3eeb3a7
Highlight other cloud offerings as well
bogdando Oct 31, 2017
36b4aa9
Update the deprecation and ref arch wording
bogdando Oct 31, 2017
27ea12a
Adjust openstack provider links
bogdando Nov 17, 2017
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
10 changes: 10 additions & 0 deletions getting_started/administrators.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,16 @@ networking. Ensure that local firewall rules and other software making iptable
changes do not alter the {product-title} and Docker service setup.
====

[[get-started-cloud-providers]]
=== On-premises vs Cloud Providers

{product-title} can be installed on-premises or hosted on public or private
clouds. For more details,
xref:../install_config/install/advanced_install.adoc#advanced-cloud-providers[see the advanced installation guide].

Once you have your cluster nodes provisioned, choose the
installation method that fits your case the best.

[[installation-methods]]
== Installation Methods

Expand Down
56 changes: 53 additions & 3 deletions install_config/install/advanced_install.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,9 +71,59 @@ see the
xref:../../scaling_performance/install_practices.adoc#scaling-performance-install-best-practices[Scaling and Performance Guide].

After following the instructions in the
xref:../../install_config/install/prerequisites.adoc#install-config-install-prerequisites[Prerequisites] topic and
deciding between the RPM and containerized methods, you can continue in this
topic to xref:configuring-ansible[Configuring Ansible Inventory Files].
xref:../../install_config/install/prerequisites.adoc#install-config-install-prerequisites[Prerequisites]
topic, deciding between the RPM and containerized methods and
xref:advanced-cloud-providers[choosing from the on-premises or cloud scenarios],
you can continue in this topic to
xref:configuring-ansible[Configuring Ansible Inventory Files].

[[advanced-cloud-providers]]
=== Choosing clouds over on-premises

Provisioning of VMs in a cloud, defining your cloud hosted infrastructure and
applying post-provision configuration may be assisted with Ansible
automation playbooks for the supported cloud providers. This advanced installation
guide is happen to fulfill that purpose as well.

ifdef::openshift-enterprise[]
====
A managed dedicated cloud hosted infrastructure may be alternatively
operated as a service by Red Hat, see the
link:https://www.openshift.com/dedicated/index.html[OpenShift Dedicated]
product offering for more details.
====

==== OpenStack provider

In order to install {product-title} with manual steps using OpenStack CLI,
see the
link:https://access.redhat.com/documentation/en-us/reference_architectures/2017/html-single/deploying_and_managing_red_hat_openshift_container_platform_3.6_on_red_hat_openstack_platform_10[reference architecture],
which is actual for {product-title} 3.6 and Red Hat OpenStack Platform 10.

As a prerequisite, you will have to provision VMs and configure the cloud
infrastructure, like network, storage, firewall and security groups.
Some of the basic configuration may be assisted by that reference architecture
and the
xref:../../install_config/install/prerequisites#prereq-cloud-provider-considerations[cloud provider considerations].
For advanced configuration prerequisites, like DNS, load balancing and high

@tomassedovic tomassedovic Oct 31, 2017

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The reference architecture handles complex deployments including HA, DNS and LB as well I believe.

I would just say that it describes a manual way of configuring the OpenStack resources and installing OpenShift and the playbooks below automate it.

@bogdando bogdando Oct 31, 2017

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@e-minguez would you comment please?

@e-minguez e-minguez Oct 31, 2017

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tomassedovic is right, the current ref. arch. includes how to deploy DNS, LB and an HA OCP environment based on manual steps for the infrastructure, then openshift-ansible for installing OCP.

@bogdando bogdando Oct 31, 2017

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done, thanks

availability, you may want to use the
link:https://github.com/openshift/openshift-ansible-contrib/tree/master/playbooks/provisioning/openstack[Ansible automation playbooks]
instead. For automated installations, see also
xref:../../install_config/configuring_openstack#install-config-configuring-openstack[Configuring for OpenStack]
and
xref:configuring-ansible[Configuring Ansible Inventory Files].

ifdef::openshift-enterprise[]
====
[IMPORTANT]
The reference architecture for automated installations based on
link:https://docs.openstack.org/heat/latest[OpenStack Heat] templates for
link:https://access.redhat.com/documentation/en-us/reference_architectures/2017/html/deploying_red_hat_openshift_container_platform_3.4_on_red_hat_openstack_platform_10[{product-title} 3.4 on Red Hat OpenStack Platform 10]
is deprecated. For OSP 13 time frame, it is being replaced with the

@e-minguez e-minguez Oct 30, 2017

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AFAIK OCP 3.6 on OSP 10 ref. arch. is not deprecated (we've just released a few weeks ago[1]), OCP 3.4 on OSP 10 is deprecated[2]
[1] https://access.redhat.com/documentation/en-us/reference_architectures/2017/html-single/deploying_and_managing_red_hat_openshift_container_platform_3.6_on_red_hat_openstack_platform_10/
[2] https://access.redhat.com/documentation/en-us/reference_architectures/2017/html/deploying_red_hat_openshift_container_platform_3.4_on_red_hat_openstack_platform_10/

@bogdando bogdando Oct 30, 2017

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tomassedovic could you please comment and help to get the better wording to point OSP >10 users to the right docs?

@bogdando bogdando Oct 31, 2017

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

@tomassedovic tomassedovic Oct 31, 2017

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure it's been officially deprecated. More like it's not being actively developed anymore.

@bogdando bogdando Oct 31, 2017 •
edited
Loading

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure the docs should state something is not being actively developed anymore :) sounds a little bit too much of dramatic.

@bogdando bogdando Oct 31, 2017

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

let it be 'unsupported'

@bogdando bogdando Oct 31, 2017

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

done

link:https://github.com/openshift/openshift-ansible-contrib/tree/master/playbooks/provisioning/openstack[Ansible driven deployment solution].

@e-minguez e-minguez Oct 30, 2017

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't know about providing links in the official documentation to the unsupported o-a-c repo

@bogdando bogdando Oct 30, 2017

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please take a look the commit message, it states that the repo is being moved and the link will have to be adjusted. So this is only a landing page, and the dependency patch. I'll put the dependency though! thanks!

For automated installations, please follow that guide instead!
====
endif::[]

[[configuring-ansible]]
== Configuring Ansible Inventory Files
Expand Down
24 changes: 24 additions & 0 deletions install_config/install/planning.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,22 @@ toc::[]
For production environments, several factors influence installation. Consider
the following questions as you read through the documentation:

* _Do you install on-premises or in public/private clouds?_ The xref:planning-cloud-providers[Installation Methods]
section provides more information about the cloud providers options available.

ifdef::openshift-enterprise[]
* _Do you need a dedicated cloud hosted infrastructure?_ There might be
managed multi-tenant alternatives as well. For example, operated as a service
by Red Hat cloud hosted infrastructure where your workloads run
alongside other customers' containers. If that fits your case, see
link:https://www.openshift.com/[OpenShift Online] for more details.

* _Will you manage your dedicated cloud hosted infrastructure or prefer
having it managed as a service?_ See the
link:https://www.openshift.com/dedicated/index.html[OpenShift Dedicated]
product offering that might fit the case better.

@bogdando bogdando Oct 31, 2017

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Kudos Chris Pitman for explaining this on a mail list

endif::[]

* _Which installation method do you want to use?_ The xref:installation-methods[Installation Methods]
section provides some information about the quick and advanced installation
methods.
Expand Down Expand Up @@ -65,6 +81,14 @@ the same installer tool. If you wanted to later switch to using the advanced
method, you can create an inventory file for your configuration and carry on
that way.

[[planning-cloud-providers]]
=== On-premises vs Cloud Providers

{product-title} can be installed on-premises or hosted on public or private
clouds. The aforementioned Ansible playbooks will help you with automation of
the provisioning and installation processes. For more details,
xref:../../install_config/install/advanced_install.adoc#advanced-cloud-providers[see the advanced installation guide].

[[sizing]]
== Sizing Considerations

Expand Down