Gestion des projets

Apprenez à créer et à gérer des projets.

Qu'est-ce qu'un projet ?

Un projet est un regroupement d'entités Code Engine telles que des applications, des travaux et des générations. Un projet est basé sur un espace de nom Kubernetes. Le nom de votre projet doit être unique au sein de votre groupe de ressources, compte utilisateur et région IBM Cloud®. Les projets permettent de gérer des ressources et fournissent un accès à leurs entités.

Un projet fournit les éléments suivants.

Il fournit un espace de nom unique pour des noms d'entité.
Il gère l'accès à des ressources de projet (accès entrant).
Il gère l'accès à des services de sauvegarde, des registres et des référentiels (accès sortant).
Il possède un certificat généré automatiquement pour TLS (Transport Layer Service).

Pour plus d'informations sur la gestion du contrôle des accès aux projets à l'aide d'IAM, voir Gestion des accès utilisateur.

Les projets n'entraînent aucun coût, mais servent de dossiers pour vos applications, vos tâches et vos fonctions.

Comment savoir quels sont les projets auxquels je peux accéder ?

Vous pouvez voir une liste de vos projets dans la console Code Engine.

Vous pouvez également exécuter la commande project list.

ibmcloud ce project list

Exemple de sortie

Getting projects...
OK

Name             ID                                    Status  Selected  Tags  Region    Resource Group  Age
myproj-eude      01234567-abcd-abcd-abcd-abcdabcd2222  active  false           eu-de     default         27d
myproject        01234567-abcd-abcd-abcd-abcdabcd1111  active  true            us-south  default         52d

Comment afficher les détails d'un projet ?

Depuis la console Code Engine, vous pouvez voir les détails d'un projet en cliquant sur le nom d'un projet dans la page Code Engine Projects.

Lorsque vous travaillez avec un composant dans Code Engine à partir de la console, comme les applications, les travaux ou les fonctions, ou leurs entités associées comme l'accès, les liaisons ou les abonnements, vous pouvez voir les détails du projet associé. Sur la page de l'entité Code Engine, cliquez sur Détails pour en savoir plus sur le projet associé. Utilisez cette page pour afficher les détails du projet associé, qui inclut des informations telles que la région, le nom de ressource de cloud (CRN), l'identificateur global unique (GUID), les adresses réseau (publiques et privées), etc.

Vous pouvez également exécuter la commande project get pour afficher les détails relatifs à un projet. Remplacez PROJECT_NAME par le nom de votre projet. Si votre projet est sélectionné comme contexte en cours, la sortie de cette commande inclut des détails concernant les limites et l'utilisation des quotas des ressources de projet Code Engine. Pour plus d'informations sur les limites applicables aux projets, voir Quotas de projet.

ibmcloud ce project get --name PROJECT_NAME

Exemple de sortie

Getting project 'myproject'...
OK

Name:                                      myproject
ID:                                        01234567-abcd-abcd-abcd-abcdabcd1111  
CRN:                                       crn:v1:bluemix:public:codeengine:au-syd:a/1a2b3c4d5e6f7g1a2b3c4d5e6f7g1234:01234567-abcd-abcd-abcd-abcdabcd1111::  
Status:                                    active
Enabled:                                   true
Application Private Visibility Supported:  true
Selected:                                  true
Region:                                    us-south
Resource Group:                            default
Service Binding Service ID:                ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                                       52d
Created:                                   Mon, 30 Jun 2025 18:16:12 +0200
Updated:                                   Mon, 30 Jun 2025 18:16:58 +0200

Connectivity:    
  Outbound - Source IP addresses:                             
    Public internet  
    159.23.99.151  
    130.198.13.241  
    135.90.137.31  

    IBM Cloud private network  
    10.223.236.11  
    10.223.242.142  
    10.12.3.244  

  Inbound - Context-based restrictions for the data plane:    
    Enforcement status:         none  
    Public internet:            allowed  
    IBM Cloud private network:  allowed  
    Last applied:               Wed, 20 May 2026 15:52:02 +0200  

Quotas:
    Category                                  Used       Limit
    App revisions                             33         100
    Apps                                      10         100
    Build runs                                4          100
    Builds                                    4          100
    Configmaps                                7          100
    CPU                                       6.15       64
    Custom domain mappings                    4          80
    Ephemeral storage                         5415750Ki  256G
    Functions                                 2          20
    Instances (active)                        6          250
    Instances (total)                         9          2500
    Job runs                                  4          100
    Jobs                                      3          100
    Memory                                    26400M     256G
    Persistent data stores                    2          10
    Private path connections                  1          3
    Secrets                                   21         100
    Serverless fleets                         42         1000
    Subnet pools                              3          20
    Subscriptions (cron)                      1          100
    Subscriptions (IBM Cloud Object Storage)  0          100

Comment définir des règles permettant à d'autres personnes de gérer mon projet ?

Reportez-vous à la rubrique Gestion des accès utilisateur pour apprendre à définir des règles IAM permettant à d'autres personnes de gérer votre projet Code Engine.

Y a-t-il des limites de projet à envisager ?

Le nombre maximal de projets que vous pouvez créer par région est 20. Pour plus d'informations sur les limites applicables aux projets, voir Quotas de projet.

Créer un projet

Vous pouvez créer un projet à l'aide de la console ou de l'interface de ligne de commande.

Création d'un projet à partir de la console

Dans la page Projets de la console Code Engine, cliquez sur Créer. Vous pouvez également créer votre projet lorsque vous créez votre application, travail ou fonction Code Engine avec le raccourci de la console Code Engine. Dans la consoleCode Engine, sélectionnez Let's go, puis cliquez sur Créer un projet dans la page Démarrer la création.
Sélectionnez un emplacement pour déployer le projet.
Entrez un nom pour le projet. Le nom doit être unique pour tous vos projets qui se trouvent dans l'emplacement spécifié.
Sélectionnez le groupe de ressources dans lequel vous voulez créer le projet.
Cliquez sur Créer.

Pour afficher l'instance de service pour la ressource du projet, allez sur votre tableau de bord IBM Cloud et trouvez le nom de votre projet dans la rubrique Code Engine.

Création d'un projet depuis l'interface de ligne de commande

Lorsque vous créez un projet, il est automatiquement sélectionné comme contexte actuel. Pour créer un projet qui n'est pas automatiquement sélectionné, utilisez l'option --no-select.

Installez l'interface de ligne de commande Code Engine. Ciblez le groupe de ressources que vous souhaitez utiliser pour le projet.
Créez un projet à l'aide de la commande project create. Utilisez un nom de projet unique dans votre région.
```
ibmcloud ce project create --name PROJECT_NAME
```
Exemple de sortie
```
Creating project 'myproject'...
OK
```

Vérifiez que votre nouveau projet a été créé en exécutant la commande project get.

ibmcloud ce project get --name PROJECT_NAME

Exemple de sortie

Getting project 'myproject'...
OK
Name:                       myproject
ID:                         01234567-abcd-abcd-abcd-abcdabcd1111
Status:                     active
Selected:                   true
Region:                     us-south
Resource Group:             default
Service Binding Service ID: ServiceId-1234abcd-abcd-abcd-1111-1a2b3c4d5e6f
Age:                        52d
Created:                    Fri, 15 Jan 2021 13:32:30 -0500
Updated:                    Fri, 15 Jan 2021 13:32:45 -0500

Quotas:
Category                                  Used      Limit
App revisions                             1         100
Apps                                      1         100
Build runs                                0         100
Builds                                    0         100
Configmaps                                2         100
CPU                                       1.025     64
Ephemeral storage                         902625Ki  256G
Instances (active)                        1         250
Instances (total)                         2         2500
Job runs                                  1         100
Jobs                                      1         100
Memory                                    4400M     256G
Secrets                                   5         100
Subscriptions (cron)                      0         100
Subscriptions (IBM Cloud Object Storage)  0         100

Vous pouvez également répertorier tous les projets et cette sortie affiche le projet sélectionné. Dans l'exemple suivant, myproject est le projet sélectionné comme contexte actuel.

ibmcloud ce project list

Exemple de sortie

Getting projects...
OK

Name             ID                                    Status  Selected  Tags  Region    Resource Group  Age
myproj-eude      01234567-abcd-abcd-abcd-abcdabcd2222  active  false           eu-de     default         27d
myproject        01234567-abcd-abcd-abcd-abcdabcd1111  active  true            us-south  default         52d

Gestion d'un projet

Après avoir créé un projet, vous pouvez le gérer à l'aide de la console ou de l'interface de ligne de commande Code Engine.

Gestion d'un projet à partir de la console

Pour travailler sur un projet, allez sur la page Code Engine Projects et cliquez sur le nom du projet dans la liste.

Pour utiliser des composants Code Engine, vous devez utiliser les composants dans le contexte d'un projet. A partir du contexte de votre projet, vous pouvez créer et utiliser des composants Code Engine, tels que des applications, des travaux ou des fonctions. Pour déterminer le projet à partir duquel vous travaillez actuellement, consultez l'élément de navigation de votre composant Code Engine.

Gestion d'un projet depuis l'interface de ligne de commande

Pour utiliser un projet depuis l'interface de ligne de commande, le projet doit être sélectionné comme contexte actuel. Un projet est automatiquement sélectionné comme contexte actuel quand il est créé, sauf si vous spécifiez l'option --no-select. Pour sélectionner un projet qui n'est pas ciblé actuellement, utilisez la commande project select.

ibmcloud ce project select --name PROJECT_NAME

Exemple de sortie

Selecting project 'myproject'...

Dans le contexte du projet sélectionné, vous pouvez utiliser des composants Code Engine, tels que des applications, des travaux ou des fonctions.

Détermination du projet sélectionné comme contexte actuel

Vous pouvez obtenir des détails sur le projet sélectionné comme contexte actuel à l'aide de la commande project current.

Suppression d'un projet

Lorsque vous n'avez plus besoin d'un projet, vous pouvez le supprimer. La suppression d'un projet supprime tous les composants qu'il contient. Vous pouvez utiliser la console ou l'interface de ligne de commande.

Lorsque vous supprimez un projet depuis la console ou depuis l'interface de ligne de commande, le projet fait l'objet d'une suppression logicielle et peut être restauré. Vous devez restaurer votre projet dans un délai de 7 jours, sinon sa suppression est définitive. Pour plus d'informations sur la restauration des projets, voir Restauration de projets supprimés. Pour supprimer définitivement un projet, voir Suppression définitive des projets.

Lorsque vous supprimez un projet, tous les projets qui ne sont pas définitivement supprimés sont comptabilisés dans le maximum de 20 projets par région autorisés.

Les noms de projet dans une région doivent être uniques. Lorsque vous effectuez la suppression logicielle d'un projet (ou supprimez le projet avec réclamation), vous ne pouvez pas réutiliser le nom du projet tant que le projet n'a pas été supprimé définitivement.

Suppression d'un projet de la console

Pour supprimer un projet de la console, allez sur la page Code Engine Projects, sélectionnez le projet que vous souhaitez supprimer et cliquez sur l'icône de suppression. Si vous ouvrez un projet spécifique, vous pouvez également le supprimer du menu Actions.

Lorsque vous supprimez un projet depuis la console, il fait l'objet d'une suppression logicielle et peut être restauré dans un délai de 7 jours avant d'être supprimé définitivement. Les récupérations de projet représentent des projets supprimés qui peuvent encore être restaurés. La page Code Engine Projects affiche le nombre de réclamations de projets. Cliquez sur restorable projects pour ouvrir la page Réclamations de projets et afficher une liste de projets qui peuvent être restaurés ou supprimés définitivement.

Suppression d'un projet depuis l'interface de ligne de commande

Pour supprimer un travail depuis l'interface de ligne de commande, utilisez la commande project delete. Si vous le souhaitez, vous pouvez utiliser l'option -f pour forcer la suppression d'un projet sans confirmation. Une fois qu'un projet a été supprimé en douceur, vous pouvez gérer ce projet à l'aide des commandes reclamation commandes. L'exemple suivant effectue une suppression de manière réversible du projet myproject,

ibmcloud ce project delete --name myproject -f

Exemple de sortie

Deleting project 'myproject'...
OK

Pour supprimer définitivement un projet afin qu'il ne puisse pas être restauré, utilisez l'option --hard avec la commande project delete. Si vous le souhaitez, vous pouvez utiliser l'option -f pour forcer la suppression d'un projet sans confirmation. L'exemple suivant effectue une suppression définitive du projet myproject1,

ibmcloud ce project delete --name myproject1 --hard -f

Exemple de sortie

Deleting project 'myproject1'...
OK

Si vous spécifiez l'option --hard dans la commande project delete, le projet est supprimé immédiatement et ne peut pas être restauré à l'aide de la réclamation de ressource IBM Cloud. Si vous ne spécifiez pas l'option --hard, le projet peut être restauré dans un délai de 7 jours à l'aide de la commande reclamation restore.

Si vous avez précédemment effectué la suppression logicielle d'un projet (sans spécifier l'option --hard), vous ne pouvez demander sa suppression ultérieure qu'à l'aide de la commande project delete avec l'option --hard. Cette action supprime complètement le projet qui ne peut alors plus être restauré.

Restauration de projets supprimés

Restauration de projets supprimés depuis la console

Après avoir effectué la suppression logicielle d'un projet, vous pouvez restaurer le projet ou le supprimer définitivement depuis la console. Vous devez restaurer votre projet dans un délai de 7 jours, sinon sa suppression est définitive.

Dans la page Projets de la console Code Engine, affichez la liste des projets de votre région. Le nombre de réclamations de projet est affiché.
Cliquez sur le lien pour project reclamations.
Depuis la page Réclamations de projet, vous pouvez consulter le nombre de jours restants pour la restauration de votre projet.
- Pour restaurer votre projet, cliquez sur l'icône de restauration.
- Pour supprimer définitivement votre projet, cliquez sur l'icône de suppression.

Si vous ne prenez pas de décision concernant un projet répertorié dans la page Réclamations de projet, le projet est supprimé définitivement au bout de 7 jours, automatiquement.

Restauration de projets supprimés depuis l'interface de ligne de commande

Les projets qui sont supprimés peuvent être gérés à l'aide des commandes reclamation . Commandes reclamation.

Reconnaissez les projets qui ont fait l'objet d'une suppression logicielle à l'aide de la commande reclamation list.

ibmcloud ce reclamation list

Exemple de sortie

Getting project reclamations...
OK
Name          ID                                    Reclamation ID                        Status        Region    Resource Group  Age   Time to Hard Deletion
myproject     def218c5-abcd-abcd-abcd-97854c288d76  48e3d7a2-abcd-abcd-abcd-99db7152b8fe  soft deleted  us-south  default         40h   6d23h
myproject2    01f0bc66-abcd-abcd-abcd-3ef7e99f6f69  af2cd017-abcd-abcd-abcd-d32e2bb79136  soft deleted  jp-osa    default         8m58s 2d11h

Utilisez la commande reclamation restore pour restaurer à l'état actif un projet ayant fait l'objet d'une suppression logicielle. L'exemple suivant restaure le projet myproject2 et ses composants : Veillez à cibler correctement la région du projet que vous souhaitez restaurer.
```
ibmcloud ce reclamation restore --name myproject
```
Exemple de sortie
```
Restoring project 'myproject'...
OK
```

Vous pouvez également utiliser la commande project restore pour restaurer à l'état actif un projet ayant fait l'objet d'une suppression logicielle.

Suppression définitive des projets

Suppression définitive des projets depuis la console

Après avoir effectué la suppression logicielle d'un projet (ou supprimé le projet avec réclamation), vous pouvez restaurer le projet ou le supprimer définitivement depuis la console. Lorsqu'un projet est supprimé définitivement, il ne peut pas être restauré.

Dans la page Projets de la console Code Engine, affichez la liste des projets de votre région. Le nombre de réclamations de projet est affiché.
Cliquez sur le lien pour project reclamations.
Depuis la page Réclamations de projet, vous pouvez consulter le nombre de jours restants pour la restauration de votre projet. Pour supprimer définitivement votre projet, cliquez sur Delete.

Si vous ne prenez pas de décision concernant la suppression des projets qui sont répertoriés dans la page Réclamations de projet, le projet est supprimé définitivement au bout de 7 jours.

Suppression définitive des projets depuis l'interface de ligne de commande

Si votre projet a fait l'objet d'une suppression logicielle, vous pouvez utiliser la commande reclamation delete pour le supprimer définitivement. L'utilisation de l'option --force avec cette commande force la suppression sans confirmation.

ibmcloud ce reclamation delete -n myproject --f

Exemple de sortie

Hard deleting project 'myproject'...
OK

Pour supprimer définitivement un projet qui n'a pas fait l'objet d'une suppression logicielle de manière à ce qu'il ne puisse pas être restauré, utilisez l'option --hard avec la commande project delete afin de spécifier la suppression immédiate et définitive du projet. Par exemple, pour supprimer définitivement le projet myproject3 :

ibmcloud ce project delete --name myproject3 --hard

Exemple de sortie

Deleting project 'myproject3'...
OK