From 8bdb7d3aeff62bb896981af541cc03b02bc699b9 Mon Sep 17 00:00:00 2001 From: Rob Szumski Date: Wed, 6 May 2020 13:59:09 -0400 Subject: [PATCH] Add Marketplace doc to 4.4 (#21179) * Add simple Marketplace doc * Modularize doc * Peer review comments + resolutions Co-authored-by: Max Bridges --- _topic_map.yml | 3 ++ applications/red-hat-marketplace.adoc | 10 ++++++ modules/red-hat-marketplace-features.adoc | 44 +++++++++++++++++++++++ 3 files changed, 57 insertions(+) create mode 100644 applications/red-hat-marketplace.adoc create mode 100644 modules/red-hat-marketplace-features.adoc diff --git a/_topic_map.yml b/_topic_map.yml index cc9390887b16..6ed78d9ff456 100644 --- a/_topic_map.yml +++ b/_topic_map.yml @@ -884,6 +884,9 @@ Topics: - Name: Pruning objects to reclaim resources File: pruning-objects Distros: openshift-origin,openshift-enterprise,openshift-webscale +- Name: Using the Red Hat Marketplace + File: red-hat-marketplace + Distros: openshift-origin,openshift-enterprise,openshift-webscale --- Name: Machine management Dir: machine_management diff --git a/applications/red-hat-marketplace.adoc b/applications/red-hat-marketplace.adoc new file mode 100644 index 000000000000..4f03f96f49e1 --- /dev/null +++ b/applications/red-hat-marketplace.adoc @@ -0,0 +1,10 @@ +[id="red-hat-marketplace"] += Using the Red Hat Marketplace +include::modules/common-attributes.adoc[] +:context: red-hat-marketplace + +toc::[] + +The link:https://marketplace.redhat.com[Red Hat Marketplace] is an open cloud marketplace that makes it easy to discover and access certified software for container-based environments that run on public clouds and on-premises. + +include::modules/red-hat-marketplace-features.adoc[leveloffset=+1] diff --git a/modules/red-hat-marketplace-features.adoc b/modules/red-hat-marketplace-features.adoc new file mode 100644 index 000000000000..77cf12ef82ea --- /dev/null +++ b/modules/red-hat-marketplace-features.adoc @@ -0,0 +1,44 @@ +// Module included in the following assemblies: +// +// * applications/red-hat-marketplace.adoc + +[id="red-hat-marketplace-features_{context}"] += Red Hat Marketplace features + +Cluster administrators can use link:https://marketplace.redhat.com/en-us/documentation/getting-started[the Red Hat Marketplace] to manage software on {product-title}, give developers self-service access to deploy application instances, and correlate application usage against a quota. + +[id="marketplace-clusters_{context}"] +== Connect {product-title} clusters to the Marketplace + +Cluster administrators can install a common set of applications on {product-title} clusters that connect to the Marketplace. They can also use the Marketplace to track cluster usage against subscriptions or quotas. Users that they add by using the Marketplace have their product usage tracked and billed to their organization. + +During the link:https://marketplace.redhat.com/en-us/documentation/clusters[cluster connection process], +a Marketplace Operator is installed that updates the image registry secret, manages the catalog, and reports application usage. + +[id="marketplace-install-applications_{context}"] +== Install applications + +Cluster administrators can link:https://marketplace.redhat.com/en-us/documentation/operators[install Marketplace applications] from within OperatorHub in {product-title}, or from the link:https://marketplace.redhat.com[Marketplace web application]. + +You can access installed applications from the web console by clicking **Operators > Installed Operators**. + +[id="marketplace-deploy_{context}"] +== Deploy applications from different perspectives + +You can deploy Marketplace applications from the web console's Administrator and Developer perspectives. + +[discrete] +=== The Developer perspective + +Developers can access newly installed capabilities by using the Developer perspective. + +For example, after a database Operator is installed, a developer can create an instance from the catalog within their project. Database usage is aggregated and reported to the cluster administrator. + +This perspective does not include Operator installation and application usage tracking. + +[discrete] +=== The Administrator perspective + +Cluster administrators can access Operator installation and application usage information from the Administrator perspective. + +They can also launch application instances by browsing custom resource definitions (CRDs) in the *Installed Operators* list. \ No newline at end of file