Skip to content

upgrade-testing.md

Latest commit

 

History

History
152 lines (123 loc) · 3.59 KB

upgrade-testing.md

File metadata and controls

152 lines (123 loc) · 3.59 KB

Upgrade testing

Follow below step for manual upgrade testing

  1. Set environment variables to overwrite values in Makefile. You should overwrite the IMAGE_OWNER and VERSION etc values for pushing container images into your quay.io account.
IMAGE_OWNER ?= IMAGE_OWNER
VERSION ?= VERSION
  1. Add replaces property in opendatahub-operator.clusterserviceversion.yaml and add version which you would like to upgrade with next version
replaces: opendatahub-operator.v2.4.0
  1. Build and push docker container image
make image
  1. Build bundle image
make bundle-build
  1. Push bundle image into registry
make bundle-push
  1. Build catalog source image
make catalog-build
  1. Push catalog source image into registry
make catalog-push

Cluster

Deploy CatalogSource on cluster to install Open Data Hub Operator.

  1. Deploy CatalogSource. Deploy catalog source on cluster by using your catalog source container image and wait until catalog source pod is ready
cat <<EOF | oc create -f -
apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: opendatahub-catalog
  namespace: openshift-marketplace
spec:
  sourceType: grpc
  image: quay.io/$IMAGE_OWNER/opendatahub-operator-catalog:$VERSION
  displayName: Open Data Hub Operator
  publisher: ODH
EOF
  1. Subscribe to the ODH custom catalog
cat <<EOF | oc create -f -
apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: opendatahub-operator
  namespace: openshift-operators
spec:
  channel: fast
  name: opendatahub-operator
  source: opendatahub-catalog
  sourceNamespace: openshift-marketplace
EOF

Upgrade to new Version

  1. Follow steps 1 to 7 to build new version of catalog-source image

  2. Apply updated version of catalog

cat <<EOF | oc apply -f -
apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: opendatahub-catalog
  namespace: openshift-marketplace
spec:
  sourceType: grpc
  image: quay.io/$IMAGE_OWNER/opendatahub-operator-catalog:$VERSION
  displayName: Open Data Hub Operator
  publisher: ODH
EOF

  1. Select fast channel to update

  2. Go to Installed Operator Open Data Hub Operator and upgrade operator with latest version under tab Subscription

Usage

  1. When Operator is installed it creates a namespace called opendatahub.
  2. Users need to create required DataScienceCluster resource by going to the Installed Operators tab in the OpenShift Cluster.
  3. Users should explicitly set components with managementState: Managed in order for components to be installed.
cat <<EOF | oc apply -f -
apiVersion: datasciencecluster.opendatahub.io/v2
kind: DataScienceCluster
metadata:
  name: example
spec:
  components:
    dashboard:
      managementState: Managed
    aipipelines:
      managementState: Managed
    kserve:
      managementState: Managed
    modelregistry:
      managementState: Managed
      registriesNamespace: "odh-model-registries"
    ray:
      managementState: Managed
    kueue:
      managementState: Managed
    trainingoperator:
      managementState: Managed
    workbenches:
      managementState: Managed
    trustyai:
      managementState: Managed
    feastoperator:
      managementState: Managed
    llamastackoperator:
      managementState: Managed
    mlflowoperator:
      managementState: Managed
    sparkoperator:
      managementState: Managed
      
EOF