Red Hat Summit Red Hat SummitSupportConsoleDéveloppeursCommencer un essaiContact

Chapitre 2. Les projets

2.1. Collaborer avec des projets
Copier lien

Le projet permet à une communauté d’utilisateurs d’organiser et de gérer leur contenu indépendamment des autres communautés.

Note

Les projets commençant par openshift- et kube- sont des projets par défaut. Ces projets hébergent des composants de cluster qui fonctionnent comme des pods et d’autres composants d’infrastructure. En tant que tel, OpenShift Dedicated ne vous permet pas de créer des projets commençant par openshift- ou kube- en utilisant la commande oc new-project. Dans le cas des clusters dédiés à OpenShift utilisant le modèle Customer Cloud Subscription (CCS), les utilisateurs disposant de privilèges cluster-admin peuvent créer ces projets à l’aide de la commande oc adm new-project.

Note

Dans les clusters dédiés OpenShift qui utilisent le modèle d’abonnement au cloud client (CCS), vous ne pouvez pas assigner un SCC à des pods créés dans l’un des espaces de noms par défaut: par défaut, kube-system, kube-public, openshift-infra et openshift. Il est impossible d’utiliser ces espaces de noms pour exécuter des pods ou des services. Il est impossible de créer des SCC pour les clusters dédiés OpenShift qui utilisent un compte cloud Red Hat, car la création de ressources SCC nécessite des privilèges d’administration de cluster.

2.1.1. Créer un projet
Copier lien

Il est possible d’utiliser la console Web OpenShift Dedicated ou l’OpenShift CLI (oc) pour créer un projet dans votre cluster.

2.1.1.1. Créer un projet en utilisant la console web
Copier lien

La console Web dédiée OpenShift vous permet de créer un projet dans votre cluster.

Note

Les projets commençant par openshift- et kube- sont considérés comme critiques par OpenShift Dedicated. En tant que tel, OpenShift Dedicated ne vous permet pas de créer des projets commençant par openshift- à l’aide de la console Web.

Conditions préalables

  • Assurez-vous que vous avez les rôles et autorisations appropriés pour créer des projets, des applications et d’autres charges de travail dans OpenShift Dedicated.

Procédure

  • Lorsque vous utilisez la perspective de l’administrateur:

    1. Accédez à Home Projets.

    2. Cliquez sur Créer un projet:

      1. Dans la boîte de dialogue Créer un projet, entrez un nom unique, tel que myproject, dans le champ Nom.
      2. Facultatif: Ajoutez le nom de l’affichage et les détails de la description pour le projet.

      3. Cliquez sur Create.

        Le tableau de bord de votre projet est affiché.

    3. Facultatif: Sélectionnez l’onglet Détails pour afficher les détails du projet.
    4. Facultatif : Si vous disposez d’autorisations adéquates pour un projet, vous pouvez utiliser l’onglet Accès au projet pour fournir ou révoquer les privilèges d’administration, d’édition et de visualisation du projet.

  • Lorsque vous utilisez la perspective Développeur:

    1. Cliquez sur le menu Projet et sélectionnez Créer un projet:

      Figure 2.1. Créer un projet

      créer un projet ODC
      View larger image
      créer un projet ODC
      1. Dans la boîte de dialogue Créer un projet, entrez un nom unique, tel que myproject, dans le champ Nom.
      2. Facultatif: Ajoutez le nom de l’affichage et les détails de la description pour le projet.
      3. Cliquez sur Create.
    2. Facultatif : Utilisez le panneau de navigation de gauche pour accéder à la vue Projet et voir le tableau de bord de votre projet.
    3. Facultatif: Dans le tableau de bord du projet, sélectionnez l’onglet Détails pour afficher les détails du projet.
    4. Facultatif : Si vous disposez d’autorisations adéquates pour un projet, vous pouvez utiliser l’onglet Accès au projet du tableau de bord du projet pour fournir ou révoquer les privilèges d’administration, d’édition et d’affichage du projet.

Ressources supplémentaires

2.1.1.2. Créer un projet en utilisant le CLI
Copier lien

Lorsque votre administrateur de cluster l’autorise, vous pouvez créer un nouveau projet.

Note

Les projets commençant par openshift- et kube- sont considérés comme critiques par OpenShift Dedicated. En tant que tel, OpenShift Dedicated ne vous permet pas de créer des projets commençant par openshift- ou kube- à l’aide de la commande oc new-project. Dans le cas des clusters dédiés à OpenShift utilisant le modèle Customer Cloud Subscription (CCS), les utilisateurs disposant de privilèges cluster-admin peuvent créer ces projets à l’aide de la commande oc adm new-project.

Procédure

  • Cours d’exécution: 

    $ oc new-project <project_name> \
    --description="<description>" --display-name="<display_name>"
    Copy to Clipboard Toggle word wrap

    À titre d’exemple: 

    $ oc new-project hello-openshift \
    --description="This is an example project" \
    --display-name="Hello OpenShift"
    Copy to Clipboard Toggle word wrap
Note

Le nombre de projets que vous êtes autorisé à créer peut être limité par l’administrateur système. Après que votre limite est atteinte, vous devrez peut-être supprimer un projet existant afin d’en créer un nouveau.

2.1.2. Affichage d’un projet
Copier lien

Il est possible d’utiliser la console Web OpenShift Dedicated ou l’OpenShift CLI (oc) pour afficher un projet dans votre cluster.

2.1.2.1. Affichage d’un projet à l’aide de la console Web
Copier lien

Consultez les projets auxquels vous avez accès à l’aide de la console Web OpenShift Dedicated.

Procédure

  • Lorsque vous utilisez la perspective de l’administrateur:

    1. Accédez à Home Projets dans le menu de navigation.
    2. Choisissez un projet à afficher. L’onglet Aperçu comprend un tableau de bord pour votre projet.
    3. Choisissez l’onglet Détails pour afficher les détails du projet.
    4. Choisissez l’onglet YAML pour afficher et mettre à jour la configuration YAML pour la ressource du projet.
    5. Choisissez l’onglet Charges de travail pour afficher les charges de travail dans le projet.
    6. Choisissez l’onglet RoleBindings pour afficher et créer des liens de rôle pour votre projet.

  • Lorsque vous utilisez la perspective Développeur:

    1. Accédez à la page Projet dans le menu de navigation.
    2. Choisissez tous les projets dans le menu déroulant Projet en haut de l’écran pour énumérer tous les projets de votre cluster.
    3. Choisissez un projet à afficher. L’onglet Aperçu comprend un tableau de bord pour votre projet.
    4. Choisissez l’onglet Détails pour afficher les détails du projet.
    5. Lorsque vous disposez d’autorisations adéquates pour un projet, sélectionnez l’onglet d’accès au projet et mettez à jour les privilèges pour le projet.

2.1.2.2. Affichage d’un projet à l’aide du CLI
Copier lien

Lorsque vous visualisez des projets, vous êtes limité à voir uniquement les projets auxquels vous avez accès en fonction de la politique d’autorisation.

Procédure

  1. Afin de consulter une liste de projets, exécutez: 

    $ oc get projects
    Copy to Clipboard Toggle word wrap

  2. Il est possible de passer du projet actuel à un projet différent pour les opérations de CLI. Le projet spécifié est ensuite utilisé dans toutes les opérations ultérieures qui manipulent le contenu à portée de projet: 

    $ oc project <project_name>
    Copy to Clipboard Toggle word wrap

Dans la perspective Développeur, vous pouvez utiliser la vue Projet pour accorder ou révoquer les autorisations d’accès à votre projet.

Conditions préalables

  • « vous avez créé un projet.

Procédure

Ajouter des utilisateurs à votre projet et leur fournir un accès Admin, Edit ou Affichage:

  1. Dans la perspective Développeur, accédez à la page Projet.
  2. Choisissez votre projet dans le menu Projet.
  3. Cliquez sur l’onglet Accès au projet.

  4. Cliquez sur Ajouter un accès pour ajouter une nouvelle ligne d’autorisations aux autorisations par défaut.

    Figure 2.2. Autorisations de projet

    autorisations de projet ODC
    View larger image
    autorisations de projet ODC
  5. Entrez le nom d’utilisateur, cliquez sur la liste déroulante Sélectionner un rôle et sélectionnez un rôle approprié.
  6. Cliquez sur Enregistrer pour ajouter les nouvelles autorisations.

Il est également possible d’utiliser:

  • La liste déroulante Sélectionner un rôle, pour modifier les autorisations d’accès d’un utilisateur existant.
  • L’icône Supprimer l’accès, pour supprimer complètement les autorisations d’accès d’un utilisateur existant au projet.
Note

Le contrôle d’accès avancé basé sur les rôles est géré dans la perspective des rôles et des rôles dans la perspective de l’administrateur.

Dans la perspective Développeur de la console web, la page d’accès Project Project permet à un administrateur de projet d’accorder des rôles aux utilisateurs dans un projet. Les rôles de cluster disponibles qui peuvent être accordés aux utilisateurs d’un projet sont l’administration, l’édition et la visualisation.

En tant qu’administrateur de cluster, vous pouvez définir quels rôles de cluster sont disponibles dans la page d’accès au projet pour tous les projets à l’échelle du cluster. Il est possible de spécifier les rôles disponibles en personnalisant l’objet spec.customization.projectAccess.availableClusterRoles dans la ressource de configuration de la console.

Conditions préalables

  • En tant qu’utilisateur, vous avez accès au cluster avec le rôle cluster-admin.

Procédure

  1. Dans la perspective de l’administrateur, accédez aux paramètres Administration Cluster.
  2. Cliquez sur l’onglet Configuration.
  3. Dans la liste des ressources de configuration, sélectionnez Console operator.openshift.io.
  4. Accédez à l’onglet YAML pour afficher et modifier le code YAML.

  5. Dans le code YAML sous Spéc, personnalisez la liste des rôles de cluster disponibles pour l’accès au projet. L’exemple suivant spécifie les rôles d’administrateur, d’édition et de visualisation par défaut: 

    apiVersion: operator.openshift.io/v1
kind: Console
metadata:
  name: cluster
# ...
spec:
  customization:
    projectAccess:
      availableClusterRoles:
      - admin
      - edit
      - view
    Copy to Clipboard Toggle word wrap
  6. Cliquez sur Enregistrer pour enregistrer les modifications apportées à la ressource de configuration de la console.

La vérification

  1. Dans la perspective Développeur, accédez à la page Projet.
  2. Choisissez un projet dans le menu Projet.
  3. Cliquez sur l’onglet Accès au projet.
  4. Cliquez sur le menu dans la colonne Rôle et vérifiez que les rôles disponibles correspondent à la configuration que vous avez appliquée à la configuration de ressource de la console.

2.1.5. Ajouter à un projet
Copier lien

Ajoutez des éléments à votre projet en utilisant la page +Ajouter dans la perspective Développeur.

Conditions préalables

  • « vous avez créé un projet.

Procédure

  1. Dans la perspective Développeur, accédez à la page +Ajouter.
  2. Choisissez votre projet dans le menu Projet.
  3. Cliquez sur un élément de la page +Ajouter, puis suivez le flux de travail.
Note

Il est également possible d’utiliser la fonction de recherche dans la page Add* pour trouver d’autres éléments à ajouter à votre projet. Cliquez * sous Ajouter en haut de la page et tapez le nom d’un composant dans le champ de recherche.

2.1.6. Contrôle de l’état du projet
Copier lien

Il est possible d’utiliser la console Web OpenShift Dedicated ou l’OpenShift CLI (oc) pour afficher l’état de votre projet.

Il est possible d’examiner l’état de votre projet à l’aide de la console web.

Conditions préalables

  • « vous avez créé un projet.

Procédure

  • Lorsque vous utilisez la perspective de l’administrateur:

    1. Accédez à Home Projets.
    2. Choisissez un projet dans la liste.
    3. Examinez l’état du projet dans la page Aperçu.

  • Lorsque vous utilisez la perspective Développeur:

    1. Accédez à la page Projet.
    2. Choisissez un projet dans le menu Projet.
    3. Examinez l’état du projet dans la page Aperçu.

2.1.6.2. Contrôle de l’état du projet en utilisant le CLI
Copier lien

Consultez l’état d’avancement de votre projet à l’aide de l’OpenShift CLI (oc).

Conditions préalables

  • L’OpenShift CLI (oc) a été installé.
  • « vous avez créé un projet.

Procédure

  1. Basculez vers votre projet: 

    $ oc project <project_name>
    1
    Copy to Clipboard Toggle word wrap
    1
    &lt;project_name&gt; par le nom de votre projet.

  2. Avoir un aperçu de haut niveau du projet: 

    $ oc status
    Copy to Clipboard Toggle word wrap

2.1.7. La suppression d’un projet
Copier lien

Il est possible d’utiliser la console Web OpenShift Dedicated ou l’OpenShift CLI (oc) pour supprimer un projet.

Lorsque vous supprimez un projet, le serveur met à jour l’état du projet vers Terminating from Active. Ensuite, le serveur efface tout le contenu d’un projet qui est dans l’état de terminaison avant de finalement supprimer le projet. Bien qu’un projet soit en état de terminaison, vous ne pouvez pas ajouter de nouveau contenu au projet. Les projets peuvent être supprimés du CLI ou de la console web.

Il est possible de supprimer un projet en utilisant la console web.

Conditions préalables

  • « vous avez créé un projet.
  • Les autorisations requises pour supprimer le projet sont requises.

Procédure

  • Lorsque vous utilisez la perspective de l’administrateur:

    1. Accédez à Home Projets.
    2. Choisissez un projet dans la liste.

    3. Cliquez sur le menu déroulant Actions du projet et sélectionnez Supprimer le projet.

      Note

      L’option Supprimer le projet n’est pas disponible si vous n’avez pas les autorisations requises pour supprimer le projet.

      1. Dans le volet Supprimer le projet?, confirmez la suppression en saisissant le nom de votre projet.
      2. Cliquez sur Supprimer.

  • Lorsque vous utilisez la perspective Développeur:

    1. Accédez à la page Projet.
    2. Choisissez le projet que vous souhaitez supprimer dans le menu Projet.

    3. Cliquez sur le menu déroulant Actions du projet et sélectionnez Supprimer le projet.

      Note

      Dans le cas où vous n’avez pas les autorisations requises pour supprimer le projet, l’option Supprimer le projet n’est pas disponible.

      1. Dans le volet Supprimer le projet?, confirmez la suppression en saisissant le nom de votre projet.
      2. Cliquez sur Supprimer.

2.1.7.2. La suppression d’un projet en utilisant le CLI
Copier lien

Il est possible de supprimer un projet en utilisant l’OpenShift CLI (oc).

Conditions préalables

  • L’OpenShift CLI (oc) a été installé.
  • « vous avez créé un projet.
  • Les autorisations requises pour supprimer le projet sont requises.

Procédure

  1. Effacer votre projet: 

    $ oc delete project <project_name>
    1
    Copy to Clipboard Toggle word wrap
    1
    &lt;project_name&gt; par le nom du projet que vous souhaitez supprimer.
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