Red Hat Summit Red Hat SummitSupportConsoleDéveloppeursCommencer un essaiContact

5.15. Les projets de manifestation de paquets migratoires au format de paquetage

La prise en charge du format de manifeste du paquet hérité pour les opérateurs est supprimée dans Red Hat OpenShift Service sur AWS 4.8 et ultérieure. Lorsque vous avez un projet Opérateur qui a été initialement créé à l’aide du format manifeste du paquet, vous pouvez utiliser le SDK de l’opérateur pour migrer le projet vers le format de paquet. Le format de paquet est le format d’emballage préféré pour Operator Lifecycle Manager (OLM) à partir de Red Hat OpenShift Service sur AWS 4.6.

Important

La version prise en charge par Red Hat de l’outil Operator SDK CLI, y compris les outils d’échafaudage et de test connexes pour les projets Opérateur, est dépréciée et devrait être supprimée dans une future version de Red Hat OpenShift Service sur AWS. Le Red Hat fournira des corrections de bogues et une prise en charge de cette fonctionnalité pendant le cycle de vie de la version actuelle, mais cette fonctionnalité ne recevra plus d’améliorations et sera supprimée du futur service Red Hat OpenShift sur les versions AWS.

La version prise en charge par Red Hat du SDK de l’opérateur n’est pas recommandée pour la création de nouveaux projets d’opérateur. Les auteurs d’opérateurs avec des projets d’opérateur existants peuvent utiliser la version de l’outil Operator SDK CLI publié avec Red Hat OpenShift Service sur AWS 4 pour maintenir leurs projets et créer des versions d’opérateur ciblant de nouvelles versions de Red Hat OpenShift Service sur AWS.

Les images de base suivantes pour les projets d’opérateur ne sont pas dépréciées. Les fonctionnalités d’exécution et les API de configuration de ces images de base sont toujours prises en charge pour les corrections de bogues et pour l’adressage des CVE.

  • L’image de base pour les projets d’opérateurs basés sur Ansible
  • L’image de base pour les projets d’opérateur basé sur Helm

Afin d’obtenir de l’information sur la version non prise en charge et gérée par la communauté du SDK de l’opérateur, voir Operator SDK (Operator Framework).

5.15.1. À propos de la migration du format d’emballage
Copier lien

La commande Operator SDK pkgman-to-bundle aide à migrer le paquet Operator Lifecycle Manager (OLM) en paquets. La commande prend un répertoire de manifestes de paquets d’entrée et génère des paquets pour chacune des versions des manifestes présentes dans le répertoire d’entrée. Ensuite, vous pouvez construire des images groupées pour chacun des paquets générés.

À titre d’exemple, considérez les Manifestes de paquets/annuaires suivants pour un projet dans le format manifeste du paquet:

Exemple de mise en page de format de paquet

packagemanifests/
└── etcd
    ├── 0.0.1
    │   ├── etcdcluster.crd.yaml
    │   └── etcdoperator.clusterserviceversion.yaml
    ├── 0.0.2
    │   ├── etcdbackup.crd.yaml
    │   ├── etcdcluster.crd.yaml
    │   ├── etcdoperator.v0.0.2.clusterserviceversion.yaml
    │   └── etcdrestore.crd.yaml
    └── etcd.package.yaml
Copy to Clipboard Toggle word wrap

Après l’exécution de la migration, les paquets suivants sont générés dans le répertoire bundle /:

Exemple de mise en page de format de paquet

bundle/
├── bundle-0.0.1
│   ├── bundle.Dockerfile
│   ├── manifests
│   │   ├── etcdcluster.crd.yaml
│   │   ├── etcdoperator.clusterserviceversion.yaml
│   ├── metadata
│   │   └── annotations.yaml
│   └── tests
│       └── scorecard
│           └── config.yaml
└── bundle-0.0.2
    ├── bundle.Dockerfile
    ├── manifests
    │   ├── etcdbackup.crd.yaml
    │   ├── etcdcluster.crd.yaml
    │   ├── etcdoperator.v0.0.2.clusterserviceversion.yaml
    │   ├── etcdrestore.crd.yaml
    ├── metadata
    │   └── annotations.yaml
    └── tests
        └── scorecard
            └── config.yaml
Copy to Clipboard Toggle word wrap

Basé sur cette mise en page générée, les images groupées pour les deux paquets sont également construites avec les noms suivants:

  • description Quay.io/exemple/etcd:0.0.1
  • ajouter au panier Quay.io/exemple/etcd:0.0.2

Les auteurs d’opérateurs peuvent utiliser le SDK de l’opérateur pour migrer un projet de format manifeste de paquet vers un projet de format groupé.

Conditions préalables

  • L’opérateur SDK CLI installé
  • Le projet opérateur initialement généré à l’aide du SDK de l’opérateur au format manifeste du paquet

Procédure

  • Employez le SDK de l’opérateur pour migrer votre projet de manifeste de paquets vers le format de paquet et générer des images groupées: 

    $ operator-sdk pkgman-to-bundle <package_manifests_dir> \
    1 
    
    [--output-dir <directory>] \
    2 
    
    --image-tag-base <image_name_base>
    3
    Copy to Clipboard Toggle word wrap
    1
    Indiquez l’emplacement du répertoire des manifestes de paquets pour le projet, tels que les Manifestes de paquets/ ou les manifestes/.
    2
    Facultatif: Par défaut, les paquets générés sont écrits localement sur le disque dans le répertoire bundle/. Il est possible d’utiliser le drapeau --output-dir pour spécifier un emplacement alternatif.
    3
    Définissez le drapeau --image-tag-base pour fournir la base du nom de l’image, tel que quay.io/example/etcd, qui sera utilisé pour les paquets. Fournissez le nom sans balise, car la balise pour les images sera définie en fonction de la version du paquet. À titre d’exemple, les noms complets d’image sont générés dans le format &lt;image_name_base&gt;:&lt;bundle_version&gt;.

La vérification

  • Assurez-vous que l’image de paquet générée fonctionne avec succès: 

    $ operator-sdk run bundle <bundle_image_name>:<tag>
    Copy to Clipboard Toggle word wrap

    Exemple de sortie

    INFO[0025] Successfully created registry pod: quay-io-my-etcd-0-9-4
INFO[0025] Created CatalogSource: etcd-catalog
INFO[0026] OperatorGroup "operator-sdk-og" created
INFO[0026] Created Subscription: etcdoperator-v0-9-4-sub
INFO[0031] Approved InstallPlan install-5t58z for the Subscription: etcdoperator-v0-9-4-sub
INFO[0031] Waiting for ClusterServiceVersion "default/etcdoperator.v0.9.4" to reach 'Succeeded' phase
INFO[0032]   Waiting for ClusterServiceVersion "default/etcdoperator.v0.9.4" to appear
INFO[0048]   Found ClusterServiceVersion "default/etcdoperator.v0.9.4" phase: Pending
INFO[0049]   Found ClusterServiceVersion "default/etcdoperator.v0.9.4" phase: Installing
INFO[0064]   Found ClusterServiceVersion "default/etcdoperator.v0.9.4" phase: Succeeded
INFO[0065] OLM has successfully installed "etcdoperator.v0.9.4"
    Copy to Clipboard Toggle word wrap

Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2025 Red Hat