Skip to content

Installing OpenShift Routes using the Venafi CLI tool

Note

Installing OpenShift Routes for cert-manager using Venafi Control Plane Operator is the recommended method for installing this component. For more information, see Installing OpenShift Routes using Venafi Control Plane Operator.

Step 1: Configure access to the Venafi OCI registry

If installing the component from a Venafi OCI registry, follow the instructions in Configuring access to the Venafi OCI Registry to enable access to the artifacts required for this component. Use venafi as the namespace.

Step 2: Generate the Venafi Kubernetes manifest

  1. If not already installed, download and install the relevant version of the Venafi CLI tool for your platform.
  2. Initialize the Venafi Kubernetes Manifest tool:

    venctl components kubernetes manifest tool init
    

    For more information on this command and its associated flags, see the venctl reference page.

  3. Issue the following command to generate a Venafi Kubernetes manifest which, when applied, will install OpenShift Routes:

    A sample command for users of the US region OCI registry:

    venctl components kubernetes manifest generate --region us --openshift-routes > venafi-components.yaml
    

    A sample command for users of the EU region OCI registry:

    venctl components kubernetes manifest generate --region eu --openshift-routes > venafi-components.yaml
    

    A sample command for users with their own organizatonal OCI registry. Be sure to update this command with the URI of your own company's registry:

    venctl components kubernetes manifest generate \
      --region custom \
      --cert-manager-custom-chart-repository oci://myregistry.example.com/charts \
      --cert-manager-custom-image-registry myregistry.example.com \
      --openshift-routes \
      --openshift-routes-custom-chart-repository oci://myregistry.example.com/charts \
      --openshift-routes-custom-image-registry myregistry.example.com > venafi-components.yaml
    

    Tip

    Add the --openshift-routes-values-files flag to point to the location of a openshift-routes.values.yaml file if you want to define additional Helm values. For more information, see the venctl command reference page, the Secret Targets section below, and the OpenShift Routes Helm values page.

  4. To apply the manifest, use the following command:

    venctl components kubernetes manifest tool sync --file venafi-components.yaml
    

    For more information and options on using the Venafi CLI tool to install this component, see the Venafi CLI tool reference page.

    Tip

    To find out the current default version of OpenShift Routes (and all the Venafi Kubernetes components you can install with the Venafi CLI tool), use the venctl components kubernetes manifest print-versions command.

Tip

You can also use the venctl components kubernetes apply command to install this component on a Kubernetes cluster quickly and easily for test purposes. Note that this command is not recommended for use in production environments.

See venctl components kubernetes apply for more information on how to use the command with this component.