From 33bc8486f543530ef9f1740e4c9674cef86b2a48 Mon Sep 17 00:00:00 2001 From: <> Date: Wed, 13 Mar 2024 18:48:25 +0000 Subject: [PATCH] Deployed 8cdb7c3 with MkDocs version: 1.5.3 --- .nojekyll | 0 404.html | 438 ++ Tasks/adding-a-catalog/index.html | 699 ++ Tasks/explore-available-packages/index.html | 600 ++ Tasks/installing-an-extension/index.html | 528 ++ Tasks/uninstall-an-extension/index.html | 481 ++ assets/images/favicon.png | Bin 0 -> 1870 bytes assets/javascripts/bundle.c8d2eff1.min.js | 29 + assets/javascripts/bundle.c8d2eff1.min.js.map | 7 + assets/javascripts/lunr/min/lunr.ar.min.js | 1 + assets/javascripts/lunr/min/lunr.da.min.js | 18 + assets/javascripts/lunr/min/lunr.de.min.js | 18 + assets/javascripts/lunr/min/lunr.du.min.js | 18 + assets/javascripts/lunr/min/lunr.el.min.js | 1 + assets/javascripts/lunr/min/lunr.es.min.js | 18 + assets/javascripts/lunr/min/lunr.fi.min.js | 18 + assets/javascripts/lunr/min/lunr.fr.min.js | 18 + assets/javascripts/lunr/min/lunr.he.min.js | 1 + assets/javascripts/lunr/min/lunr.hi.min.js | 1 + assets/javascripts/lunr/min/lunr.hu.min.js | 18 + assets/javascripts/lunr/min/lunr.hy.min.js | 1 + assets/javascripts/lunr/min/lunr.it.min.js | 18 + assets/javascripts/lunr/min/lunr.ja.min.js | 1 + assets/javascripts/lunr/min/lunr.jp.min.js | 1 + assets/javascripts/lunr/min/lunr.kn.min.js | 1 + assets/javascripts/lunr/min/lunr.ko.min.js | 1 + assets/javascripts/lunr/min/lunr.multi.min.js | 1 + assets/javascripts/lunr/min/lunr.nl.min.js | 18 + assets/javascripts/lunr/min/lunr.no.min.js | 18 + assets/javascripts/lunr/min/lunr.pt.min.js | 18 + assets/javascripts/lunr/min/lunr.ro.min.js | 18 + assets/javascripts/lunr/min/lunr.ru.min.js | 18 + assets/javascripts/lunr/min/lunr.sa.min.js | 1 + .../lunr/min/lunr.stemmer.support.min.js | 1 + assets/javascripts/lunr/min/lunr.sv.min.js | 18 + assets/javascripts/lunr/min/lunr.ta.min.js | 1 + assets/javascripts/lunr/min/lunr.te.min.js | 1 + assets/javascripts/lunr/min/lunr.th.min.js | 1 + assets/javascripts/lunr/min/lunr.tr.min.js | 18 + assets/javascripts/lunr/min/lunr.vi.min.js | 1 + assets/javascripts/lunr/min/lunr.zh.min.js | 1 + assets/javascripts/lunr/tinyseg.js | 206 + assets/javascripts/lunr/wordcut.js | 6708 +++++++++++++++++ .../workers/search.b8dbb3d2.min.js | 42 + .../workers/search.b8dbb3d2.min.js.map | 7 + assets/stylesheets/main.7e359304.min.css | 1 + assets/stylesheets/main.7e359304.min.css.map | 1 + assets/stylesheets/palette.06af60db.min.css | 1 + .../stylesheets/palette.06af60db.min.css.map | 1 + components/index.html | 485 ++ demos/coast-to-coast-q4-2023/index.html | 1545 ++++ drafts/support-watchNamespaces/index.html | 519 ++ drafts/upgrade-support/index.html | 560 ++ drafts/version-ranges/index.html | 667 ++ index.html | 497 ++ olmv1_roadmap/index.html | 868 +++ requirements.txt | 35 + search/search_index.json | 1 + sitemap.xml | 3 + sitemap.xml.gz | Bin 0 -> 127 bytes 60 files changed, 15216 insertions(+) create mode 100644 .nojekyll create mode 100644 404.html create mode 100644 Tasks/adding-a-catalog/index.html create mode 100644 Tasks/explore-available-packages/index.html create mode 100644 Tasks/installing-an-extension/index.html create mode 100644 Tasks/uninstall-an-extension/index.html create mode 100644 assets/images/favicon.png create mode 100644 assets/javascripts/bundle.c8d2eff1.min.js create mode 100644 assets/javascripts/bundle.c8d2eff1.min.js.map create mode 100644 assets/javascripts/lunr/min/lunr.ar.min.js create mode 100644 assets/javascripts/lunr/min/lunr.da.min.js create mode 100644 assets/javascripts/lunr/min/lunr.de.min.js create mode 100644 assets/javascripts/lunr/min/lunr.du.min.js create mode 100644 assets/javascripts/lunr/min/lunr.el.min.js create mode 100644 assets/javascripts/lunr/min/lunr.es.min.js create mode 100644 assets/javascripts/lunr/min/lunr.fi.min.js create mode 100644 assets/javascripts/lunr/min/lunr.fr.min.js create mode 100644 assets/javascripts/lunr/min/lunr.he.min.js create mode 100644 assets/javascripts/lunr/min/lunr.hi.min.js create mode 100644 assets/javascripts/lunr/min/lunr.hu.min.js create mode 100644 assets/javascripts/lunr/min/lunr.hy.min.js create mode 100644 assets/javascripts/lunr/min/lunr.it.min.js create mode 100644 assets/javascripts/lunr/min/lunr.ja.min.js create mode 100644 assets/javascripts/lunr/min/lunr.jp.min.js create mode 100644 assets/javascripts/lunr/min/lunr.kn.min.js create mode 100644 assets/javascripts/lunr/min/lunr.ko.min.js create mode 100644 assets/javascripts/lunr/min/lunr.multi.min.js create mode 100644 assets/javascripts/lunr/min/lunr.nl.min.js create mode 100644 assets/javascripts/lunr/min/lunr.no.min.js create mode 100644 assets/javascripts/lunr/min/lunr.pt.min.js create mode 100644 assets/javascripts/lunr/min/lunr.ro.min.js create mode 100644 assets/javascripts/lunr/min/lunr.ru.min.js create mode 100644 assets/javascripts/lunr/min/lunr.sa.min.js create mode 100644 assets/javascripts/lunr/min/lunr.stemmer.support.min.js create mode 100644 assets/javascripts/lunr/min/lunr.sv.min.js create mode 100644 assets/javascripts/lunr/min/lunr.ta.min.js create mode 100644 assets/javascripts/lunr/min/lunr.te.min.js create mode 100644 assets/javascripts/lunr/min/lunr.th.min.js create mode 100644 assets/javascripts/lunr/min/lunr.tr.min.js create mode 100644 assets/javascripts/lunr/min/lunr.vi.min.js create mode 100644 assets/javascripts/lunr/min/lunr.zh.min.js create mode 100644 assets/javascripts/lunr/tinyseg.js create mode 100644 assets/javascripts/lunr/wordcut.js create mode 100644 assets/javascripts/workers/search.b8dbb3d2.min.js create mode 100644 assets/javascripts/workers/search.b8dbb3d2.min.js.map create mode 100644 assets/stylesheets/main.7e359304.min.css create mode 100644 assets/stylesheets/main.7e359304.min.css.map create mode 100644 assets/stylesheets/palette.06af60db.min.css create mode 100644 assets/stylesheets/palette.06af60db.min.css.map create mode 100644 components/index.html create mode 100644 demos/coast-to-coast-q4-2023/index.html create mode 100644 drafts/support-watchNamespaces/index.html create mode 100644 drafts/upgrade-support/index.html create mode 100644 drafts/version-ranges/index.html create mode 100644 index.html create mode 100644 olmv1_roadmap/index.html create mode 100644 requirements.txt create mode 100644 search/search_index.json create mode 100644 sitemap.xml create mode 100644 sitemap.xml.gz diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 000000000..e69de29bb diff --git a/404.html b/404.html new file mode 100644 index 000000000..e32a0065a --- /dev/null +++ b/404.html @@ -0,0 +1,438 @@ + + + +
+ + + + + + + + + + + + + + +Extension authors can publish their products in catalogs. +Catalogs are curated collections of Kubernetes extensions, such as Operators. +Cluster administrators can add these catalogs to their cluster. +Cluster administrators can enable polling to get over-the-air updates to catalogs when extension authors publish changes such as bug fixes and new features.
+For example, the Kubernetes community Operators catalog is a catalog of curated extensions that is developed by the Kubernetes community. +You can see the available extensions at Operatorhub.io. +This catalog is distributed as an image quay.io/operatorhubio/catalog that can be installed on clusters.
+kind
, using an account with cluster-admin
permissionskubectl
) installed on your workstationCreate a catalog custom resource (CR):
+apiVersion: catalogd.operatorframework.io/v1alpha1
+kind: Catalog
+metadata:
+ name: operatorhubio
+spec:
+ source:
+ type: image
+ image:
+ ref: <catalog_image>
+ pollInterval: <poll_interval_duration>
+
catalog_name
quay.io/operatorhubio/catalog:latest
.poll_interval_duration
24h
.
+ Valid units include seconds (s
), minutes (m
), and hours (h
).
+ To disable polling, set a zero value, such as 0s
.Apply the catalog CR:
+ + +Run the following commands to verify the status of your catalog:
+Check if your catalog is available on the cluster:
+ + +Check the status of your catalog:
+ +Name: operatorhubio
+Namespace:
+Labels: <none>
+Annotations: <none>
+API Version: catalogd.operatorframework.io/v1alpha1
+Kind: Catalog
+Metadata:
+ Creation Timestamp: 2024-03-12T19:34:50Z
+ Finalizers:
+ catalogd.operatorframework.io/delete-server-cache
+ Generation: 2
+ Resource Version: 6469
+ UID: 2e2778cb-dda6-4645-96b7-992e8dd37503
+Spec:
+ Source:
+ Image:
+ Poll Interval: 15m0s
+ Ref: quay.io/operatorhubio/catalog:latest
+ Type: image
+Status:
+ Conditions:
+ Last Transition Time: 2024-03-12T19:35:34Z
+ Message:
+ Reason: UnpackSuccessful
+ Status: True
+ Type: Unpacked
+ Content URL: http://catalogd-catalogserver.catalogd-system.svc/catalogs/operatorhubio/all.json
+ Observed Generation: 2
+ Phase: Unpacked
+ Resolved Source:
+ Image:
+ Last Poll Attempt: 2024-03-12T19:35:26Z
+ Ref: quay.io/operatorhubio/catalog:latest
+ Resolved Ref: quay.io/operatorhubio/catalog@sha256:dee29aaed76fd1c72b654b9bc8bebc4b48b34fd8d41ece880524dc0c3c1c55ec
+ Type: image
+Events: <none>
+
The packages available for installation/receiving updates on cluster can be explored by querying the Package
and BundleMetadata
CRs:
$ kubectl get packages
+NAME AGE
+operatorhubio-ack-acm-controller 3m12s
+operatorhubio-ack-apigatewayv2-controller 3m12s
+operatorhubio-ack-applicationautoscaling-controller 3m12s
+operatorhubio-ack-cloudtrail-controller 3m12s
+operatorhubio-ack-dynamodb-controller 3m12s
+operatorhubio-ack-ec2-controller 3m12s
+operatorhubio-ack-ecr-controller 3m12s
+operatorhubio-ack-eks-controller 3m12s
+operatorhubio-ack-elasticache-controller 3m12s
+operatorhubio-ack-emrcontainers-controller 3m12s
+operatorhubio-ack-eventbridge-controller 3m12s
+operatorhubio-ack-iam-controller 3m12s
+operatorhubio-ack-kinesis-controller 3m12s
+operatorhubio-ack-kms-controller 3m12s
+operatorhubio-ack-lambda-controller 3m12s
+operatorhubio-ack-memorydb-controller 3m12s
+operatorhubio-ack-mq-controller 3m12s
+operatorhubio-ack-opensearchservice-controller 3m12s
+.
+.
+.
+
+$ kubectl get bundlemetadata
+NAME AGE
+operatorhubio-ack-acm-controller.v0.0.1 3m58s
+operatorhubio-ack-acm-controller.v0.0.2 3m58s
+operatorhubio-ack-acm-controller.v0.0.4 3m58s
+operatorhubio-ack-acm-controller.v0.0.5 3m58s
+operatorhubio-ack-acm-controller.v0.0.6 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.10 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.11 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.12 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.13 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.14 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.15 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.16 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.17 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.18 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.19 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.20 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.21 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.22 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.0.9 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.1.0 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.1.1 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.1.2 3m58s
+operatorhubio-ack-apigatewayv2-controller.v0.1.3 3m58s
+.
+.
+.
+
Individual Package
/BundleMetadata
CRs can then be explored more by retrieving their yamls. Eg the operatorhubio-argocd-operator
CR has more detailed information about the argocd-operator
:
$ kubectl get packages | grep argocd
+operatorhubio-argocd-operator 5m19s
+operatorhubio-argocd-operator-helm 5m19s
+
+$ kubectl get package operatorhubio-argocd-operator -o yaml
+apiVersion: catalogd.operatorframework.io/v1alpha1
+kind: Package
+metadata:
+ creationTimestamp: "2023-06-16T14:34:04Z"
+ generation: 1
+ labels:
+ catalog: operatorhubio
+ name: operatorhubio-argocd-operator
+ ownerReferences:
+ - apiVersion: catalogd.operatorframework.io/v1alpha1
+ blockOwnerDeletion: true
+ controller: true
+ kind: Catalog
+ name: operatorhubio
+ uid: 9a949664-9069-4376-9a66-a9921f7488e2
+ resourceVersion: "3765"
+ uid: 43396920-4af4-4daf-a069-be68b8a0631e
+spec:
+ catalog:
+ name: operatorhubio
+ channels:
+ - entries:
+ - name: argocd-operator.v0.0.11
+ replaces: argocd-operator.v0.0.9
+ - name: argocd-operator.v0.0.12
+ replaces: argocd-operator.v0.0.11
+ - name: argocd-operator.v0.0.13
+ replaces: argocd-operator.v0.0.12
+ - name: argocd-operator.v0.0.14
+ replaces: argocd-operator.v0.0.13
+ - name: argocd-operator.v0.0.15
+ replaces: argocd-operator.v0.0.14
+ - name: argocd-operator.v0.0.2
+ - name: argocd-operator.v0.0.3
+ replaces: argocd-operator.v0.0.2
+ - name: argocd-operator.v0.0.4
+ replaces: argocd-operator.v0.0.3
+ - name: argocd-operator.v0.0.5
+ replaces: argocd-operator.v0.0.4
+ - name: argocd-operator.v0.0.6
+ replaces: argocd-operator.v0.0.5
+ - name: argocd-operator.v0.0.8
+ replaces: argocd-operator.v0.0.6
+ - name: argocd-operator.v0.0.9
+ replaces: argocd-operator.v0.0.8
+ - name: argocd-operator.v0.1.0
+ replaces: argocd-operator.v0.0.15
+ - name: argocd-operator.v0.2.0
+ replaces: argocd-operator.v0.1.0
+ - name: argocd-operator.v0.2.1
+ replaces: argocd-operator.v0.2.0
+ - name: argocd-operator.v0.3.0
+ replaces: argocd-operator.v0.2.1
+ - name: argocd-operator.v0.4.0
+ replaces: argocd-operator.v0.3.0
+ - name: argocd-operator.v0.5.0
+ replaces: argocd-operator.v0.4.0
+ - name: argocd-operator.v0.6.0
+ replaces: argocd-operator.v0.5.0
+ name: ""
+ defaultChannel: ""
+ description: ""
+ icon:
+ data: PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+CjwhRE9DVFlQRSBzdmcgUFVCTElDICItLy9XM0MvL0RURCBTVkcgMS4xLy9FTiIgImh0dHA6Ly93d3cudzMub3JnL0dyYXBoaWNzL1NWRy8xLjEvRFREL3N2Z==
+ mediatype: image/svg+xml
+ packageName: argocd-operator
+status: {}
+
This CR is most helpful when exploring the versions of a package that are available for installation on cluster, and the upgrade graph of versions (eg if v0.5.0 of argocd-operator
is installed on cluster, what is the next upgrade available? The answer is v0.6.0).
Creating a ClusterExtension CR installs the extension on cluster:
+$ kubectl get packages | grep argocd
+operatorhubio-argocd-operator 5m19s
+operatorhubio-argocd-operator-helm 5m19s
+
+$ kubectl apply -f - <<EOF
+apiVersion: olm.operatorframework.io/v1alpha1
+kind: ClusterExtension
+metadata:
+ name: argocd-operator
+spec:
+ packageName: operatorhubio-argocd-operator
+EOF
+
+$ kubectl get clusterextensions
+NAME AGE
+operatorhubio-argocd-operator 53s
+
+$ kubectl get clusterextension argocd-operator -o yaml
+apiVersion: olm.operatorframework.io/v1alpha1
+kind: ClusterExtension
+metadata:
+ annotations:
+ kubectl.kubernetes.io/last-applied-configuration: |
+ {"apiVersion":"olm.operatorframework.io/v1alpha1","kind":"ClusterExtension","metadata":{"annotations":{},"name":"argocd-operator"},"spec":{"packageName":"argocd-operator"}}
+ creationTimestamp: "2023-06-21T14:57:50Z"
+ generation: 1
+ name: argocd-operator
+ resourceVersion: "10690"
+ uid: 6e0c67a5-eb9c-41c6-a455-140b28714d34
+spec:
+ packageName: operatorhubio-argocd-operator
+status:
+ conditions:
+ - lastTransitionTime: "2023-06-21T14:57:51Z"
+ message: resolved to "quay.io/operatorhubio/argocd-operator@sha256:1a9b3c8072f2d7f4d6528fa32905634d97b7b4c239ef9887e3fb821ff033fef6"
+ observedGeneration: 1
+ reason: Success
+ status: "True"
+ type: Resolved
+ - lastTransitionTime: "2023-06-21T14:57:57Z"
+ message: installed from "quay.io/operatorhubio/argocd-operator@sha256:1a9b3c8072f2d7f4d6528fa32905634d97b7b4c239ef9887e3fb821ff033fef6"
+ observedGeneration: 1
+ reason: Success
+ status: "True"
+ type: Installed
+ installedBundleResource: quay.io/operatorhubio/argocd-operator@sha256:1a9b3c8072f2d7f4d6528fa32905634d97b7b4c239ef9887e3fb821ff033fef6
+ resolvedBundleResource: quay.io/operatorhubio/argocd-operator@sha256:1a9b3c8072f2d7f4d6528fa32905634d97b7b4c239ef9887e3fb821ff033fef6
+
The status condition type Installed
:true
indicates that the extension was installed successfully. We can confirm this by looking at the workloads that were created as a result of this extension installation:
Uninstalling an extension is as simple as deleting an existing ClusterExtension CR:
+ + + + + + + + + + + + + + +{"use strict";/*!
+ * escape-html
+ * Copyright(c) 2012-2013 TJ Holowaychuk
+ * Copyright(c) 2015 Andreas Lubbe
+ * Copyright(c) 2015 Tiancheng "Timothy" Gu
+ * MIT Licensed
+ */var Va=/["'&<>]/;qn.exports=za;function za(e){var t=""+e,r=Va.exec(t);if(!r)return t;var o,n="",i=0,s=0;for(i=r.index;i