Red Hat Summit Red Hat SummitSupportoConsoleSviluppatoriInizia una provaContatti

Questo contenuto non è disponibile nella lingua selezionata.

Chapter 1. 3scale operator-based upgrade guide: from 2.12 to 2.13

Note
  • 3scale 2.13.1 introduces support for Red Hat OpenShift Container Platform (OCP) 4.12.
  • You must upgrade to 3scale 2.13.1 before you upgrade to OCP 4.12.

Upgrade Red Hat 3scale API Management from version 2.12 to 2.13, in an operator-based installation to manage 3scale on OpenShift 4.x.

To automatically obtain a micro-release of 3scale, make sure automatic updates is on. To check this, see Configuring automated application of micro releases.

Important

To understand the required conditions and procedures, read the entire upgrade guide before applying the listed steps. The upgrade process disrupts the provision of the service until the procedure finishes. Due to this disruption, be sure to have a maintenance window.

Note

To scale up or down replicas during the upgrade procedure, use the fields documented in the 3scale Reconciliation section.

1.1. Prerequisites to perform the upgrade
Copia collegamento

This section describes the required configurations to upgrade 3scale from 2.12 to 2.13 in an operator-based installation.

  • An OpenShift Container Platform (OCP) 4.8, 4.9, 4.10, or 4.11 cluster with administrator access.
  • 3scale 2.12 previously deployed via the 3scale operator.

  • Make sure the latest CSV of the threescale-2.12 channel is in use. To check it:

    • If the approval setting for the subscription is automatic you should already be in the latest CSV version of the channel.
    • If the approval setting for the subscription is manual make sure you approve all pending InstallPlans and have the latest CSV version.
    • Keep in mind if there is a pending install plan, there might be more pending install plans, which will only be shown after the existing pending plan has been installed.

1.2. Upgrading from 2.12 to 2.13 in an operator-based installation
Copia collegamento

To upgrade 3scale from version 2.12 to 2.13 in an operator-based deployment:

  1. Log in to the OCP console using the account with administrator privileges.
  2. Select the project where the 3scale-operator has been deployed.
  3. Click Operators > Installed Operators.
  4. Select Red Hat Integration - 3scale > Subscription > Channel.

  5. Edit the channel of the subscription by selecting threescale-2.13 and save the changes.

    This will start the upgrade process.

  6. Query the pods' status on the project until you see all the new versions are running and ready without errors: 

    $ oc get pods -n <3scale_namespace>
    Copy to Clipboard Toggle word wrap
    Note
    • The pods might have temporary errors during the upgrade process.
    • The time required to upgrade pods can vary from 5-10 minutes.
  7. After new pod versions are running, confirm a successful upgrade by logging in to the 3scale Admin Portal and checking that it works as expected.

  8. Check the status of the APIManager objects and get the YAML content by running the following command. <myapimanager> represents the name of your APIManager: 

    $ oc get apimanager <myapimanager> -n <3scale_namespace> -o yaml
    Copy to Clipboard Toggle word wrap

    • The new annotations with the values should be as follows: 

      apps.3scale.net/apimanager-threescale-version: "2.13"
apps.3scale.net/threescale-operator-version: "0.10.0"
      Copy to Clipboard Toggle word wrap

After you have performed all steps, 3scale upgrade from 2.12 to 2.13 in an operator-based deployment is complete.

Torna in cima
Red Hat logoGithubredditYoutubeTwitter

Formazione

Prova, acquista e vendi

Community

Informazioni sulla documentazione di Red Hat

Aiutiamo gli utenti Red Hat a innovarsi e raggiungere i propri obiettivi con i nostri prodotti e servizi grazie a contenuti di cui possono fidarsi. Esplora i nostri ultimi aggiornamenti.

Rendiamo l’open source più inclusivo

Red Hat si impegna a sostituire il linguaggio problematico nel codice, nella documentazione e nelle proprietà web. Per maggiori dettagli, visita il Blog di Red Hat.

Informazioni su Red Hat

Forniamo soluzioni consolidate che rendono più semplice per le aziende lavorare su piattaforme e ambienti diversi, dal datacenter centrale all'edge della rete.

Theme

© 2025 Red Hat