mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
97bae04edb
resolving error in HCP topic map indentation removed the < and replaced with brackets for tech preview in HCP topic map removed the < and replaced with brackets for Operators tech preview in HCP topic map removed the file with tech preview for Operators in HCP topic map applied conditions to 20 xrefs because the networking, cli, authentication and observability books are not in HCP repo yet added blank line after and endif and an include module
97 lines
5.5 KiB
Plaintext
97 lines
5.5 KiB
Plaintext
:_mod-docs-content-type: ASSEMBLY
|
|
[id="osdk-helm-tutorial"]
|
|
= Operator SDK tutorial for Helm-based Operators
|
|
include::_attributes/common-attributes.adoc[]
|
|
:context: osdk-helm-tutorial
|
|
|
|
toc::[]
|
|
|
|
Operator developers can take advantage of link:https://helm.sh/docs/[Helm] support in the Operator SDK to build an example Helm-based Operator for Nginx and manage its lifecycle. This tutorial walks through the following process:
|
|
|
|
* Create a Nginx deployment
|
|
* Ensure that the deployment size is the same as specified by the `Nginx` custom resource (CR) spec
|
|
* Update the `Nginx` CR status using the status writer with the names of the `nginx` pods
|
|
|
|
include::snippets/osdk-deprecation.adoc[]
|
|
|
|
This process is accomplished using two centerpieces of the Operator Framework:
|
|
|
|
Operator SDK:: The `operator-sdk` CLI tool and `controller-runtime` library API
|
|
|
|
Operator Lifecycle Manager (OLM):: Installation, upgrade, and role-based access control (RBAC) of Operators on a cluster
|
|
|
|
ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
[NOTE]
|
|
====
|
|
This tutorial goes into greater detail than xref:../../../operators/operator_sdk/helm/osdk-helm-quickstart.adoc#osdk-helm-quickstart[Getting started with Operator SDK for Helm-based Operators].
|
|
====
|
|
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
|
|
// The "Getting started" quickstarts require cluster-admin and are therefore only available in OCP.
|
|
ifdef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
[NOTE]
|
|
====
|
|
This tutorial goes into greater detail than link:https://access.redhat.com/documentation/en-us/openshift_container_platform/4.13/html-single/operators/index#osdk-helm-quickstart[Getting started with Operator SDK for Helm-based Operators] in the OpenShift Container Platform documentation.
|
|
====
|
|
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
|
|
include::modules/osdk-common-prereqs.adoc[leveloffset=+1]
|
|
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
* xref:../../../operators/operator_sdk/osdk-installing-cli.adoc#osdk-installing-cli[Installing the Operator SDK CLI]
|
|
// TODO-HCP remove line 44 and 46 ifndef conditions for HCP after cli_tools book is migrated
|
|
ifndef::openshift-rosa-hcp[]
|
|
* xref:../../../cli_reference/openshift_cli/getting-started-cli.adoc#getting-started-cli[Getting started with the OpenShift CLI]
|
|
endif::openshift-rosa-hcp[]
|
|
|
|
include::modules/osdk-create-project.adoc[leveloffset=+1]
|
|
include::modules/osdk-helm-existing-chart.adoc[leveloffset=+2]
|
|
include::modules/osdk-project-file.adoc[leveloffset=+2]
|
|
|
|
include::modules/osdk-helm-logic.adoc[leveloffset=+1]
|
|
include::modules/osdk-helm-sample-chart.adoc[leveloffset=+2]
|
|
include::modules/osdk-helm-modify-cr.adoc[leveloffset=+2]
|
|
|
|
include::modules/osdk-run-proxy.adoc[leveloffset=+1]
|
|
|
|
|
|
include::modules/osdk-run-operator.adoc[leveloffset=+1]
|
|
|
|
ifdef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
[role="_additional-resources"]
|
|
.Additional resources
|
|
* link:https://access.redhat.com/documentation/en-us/openshift_container_platform/4.13/html-single/operators/index#osdk-run-locally_osdk-helm-tutorial[Running locally outside the cluster] (OpenShift Container Platform documentation)
|
|
* link:https://access.redhat.com/documentation/en-us/openshift_container_platform/4.13/html-single/operators/index#osdk-run-deployment_osdk-helm-tutorial[Running as a deployment on the cluster] (OpenShift Container Platform documentation)
|
|
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
|
|
// In OSD/ROSA, the only applicable option for running the Operator is to bundle and deploy with OLM.
|
|
ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
include::modules/osdk-run-locally.adoc[leveloffset=+2]
|
|
include::modules/osdk-run-deployment.adoc[leveloffset=+2]
|
|
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
|
|
[id="osdk-bundle-deploy-olm_{context}"]
|
|
=== Bundling an Operator and deploying with Operator Lifecycle Manager
|
|
|
|
include::modules/osdk-bundle-operator.adoc[leveloffset=+3]
|
|
include::modules/osdk-deploy-olm.adoc[leveloffset=+3]
|
|
|
|
include::modules/osdk-create-cr.adoc[leveloffset=+1]
|
|
|
|
[id="osdk-helm-tutorial-addtl-resources"]
|
|
[role="_additional-resources"]
|
|
== Additional resources
|
|
|
|
* See xref:../../../operators/operator_sdk/helm/osdk-helm-project-layout.adoc#osdk-helm-project-layout[Project layout for Helm-based Operators] to learn about the directory structures created by the Operator SDK.
|
|
ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
* If a xref:../../../networking/enable-cluster-wide-proxy.adoc#enable-cluster-wide-proxy[cluster-wide egress proxy is configured], cluster administrators can xref:../../../operators/admin/olm-configuring-proxy-support.adoc#olm-configuring-proxy-support[override the proxy settings or inject a custom CA certificate] for specific Operators running on Operator Lifecycle Manager (OLM).
|
|
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
ifdef::openshift-dedicated,openshift-rosa[]
|
|
// TODO-HCP remove line 92 and 94 ifndef conditions for HCP after networking book is migrated ad put the hcp condition back on line 90 and 95
|
|
ifndef::openshift-rosa-hcp[]
|
|
* If a xref:../../../networking/configuring-cluster-wide-proxy.adoc#configuring-a-cluster-wide-proxy[cluster-wide egress proxy is configured], administrators with the `dedicated-admin` role can xref:../../../operators/admin/olm-configuring-proxy-support.adoc#olm-configuring-proxy-support[override the proxy settings or inject a custom CA certificate] for specific Operators running on Operator Lifecycle Manager (OLM).
|
|
endif::openshift-rosa-hcp[]
|
|
endif::openshift-dedicated,openshift-rosa[]
|
|
|