Projekte verwalten

In diesem Abschnitt erfahren Sie, wie Sie Projekte erstellen und mit diesen arbeiten.

Was ist ein Projekt?

Ein Projekt besteht aus einer Reihe von Code Engine-Entitäten wie zum Beispiel Anwendungen, Jobs oder Builds. Ein Projekt basiert auf einem Kubernetes-Namensbereich. Der Name des Projekts muss innerhalb der Ressourcengruppe, des Benutzerkontos und der Region von IBM Cloud® eindeutig sein. Projekte werden zum Verwalten von Ressourcen und bereitstellen von Zugriff auf ihre Entitäten verwendet.

Ein Projekt stellt die folgenden Elemente bereit.

Bereitstellung eines eindeutigen Namensbereichs für Entitätsnamen.
Verwaltung des Zugriffs auf die Projektressource (eingehender Zugriff).
Verwaltung des Zugriffs auf Unterstützungsservices, Registrys und Repositorys (ausgehender Zugriff).
Automatisch generiertes Zertifikat für TLS (Transport Layer Service).

Weitere Informationen zum Verwalten der Zugriffssteuerung für Projekte mit IAM finden Sie in Benutzerzugriff verwalten.

Projekte verursachen keine Kosten, sondern dienen als Ordner für Ihre Anwendungen, Aufträge und Funktionen.

Wie kann ich feststellen, auf welche Projekte ich zugreifen kann?

Sie können eine Liste Ihrer Projekte in der Code Engine Konsole sehen.

Sie können auch den Befehl project list ausführen.

ibmcloud ce project list

Beispielausgabe

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

Wie kann ich Details zu einem Projekt anzeigen?

In der Konsole Code Engine können Sie Details zu einem Projekt anzeigen, indem Sie auf den Namen eines Projekts auf der Seite Code Engine Projekte klicken.

Wenn Sie von der Konsole aus mit einer Komponente in Code Engine arbeiten, z. B. mit Anwendungen, Aufträgen oder Funktionen oder ihren zugehörigen Entitäten wie Zugriff, Bindungen oder Abonnements, können Sie Details zum zugehörigen Projekt anzeigen. Klicken Sie auf der Seite der jeweiligen Code Engine Einheit auf Details, um mehr über das zugehörige Projekt zu erfahren. Verwenden Sie diese Seite, um Details des zugeordneten Projekts anzuzeigen, einschließlich Informationen wie die Region, CRN (Cloud Resource Name), GUID (Globally Unique Identifier), Netzadressen (öffentlich und privat) usw.

Sie können auch den Befehl project get ausführen, um Details eines Projekts anzuzeigen. Ersetzen Sie PROJECT_NAME durch den Namen Ihres Projekts. Wenn Ihr Projekt als aktueller Kontext ausgewählt wird, enthält die Ausgabe dieses Befehls Details zur Begrenzung und Kontingentverwendung von Code Engine Projektressourcen. Weitere Informationen zu Grenzwerten für Projekte finden Sie im Thema Projektkontingente.

ibmcloud ce project get --name PROJECT_NAME

Beispielausgabe

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

Wie kann ich die Richtlinien so festlegen, dass andere mit meinem Projekt arbeiten können?

Überprüfen Sie die Informationen zum Verwalten des Benutzerzugriffs, um sich damit vertraut zu machen, wie Sie die IAM-Richtlinien festlegen müssen, damit andere Benutzer mit Ihren Code Engine-Projekten arbeiten können.

Gibt es Projektgrenzwerte, die zu berücksichtigen sind?

Die maximale Anzahl an Projekten, die pro Region erstellt werden können, ist 20. Weitere Informationen zu Grenzwerten für Projekte finden Sie im Thema Projektkontingente.

Projekt erstellen

Sie können ein Projekt in der Konsole oder in der Befehlszeilenschnittstelle erstellen.

Projekt in der Konsole erstellen

Klicken Sie auf der Seite Projekte in der Konsole Code Engine auf Erstellen. Alternativ können Sie Ihr Projekt erstellen, wenn Sie die App, den Job oder die Funktion Code Engine mit dem Direktaufruf der Code Engine-Konsole erstellen. Wählen Sie in der Code Engine-Konsoledie Option Let' s go aus und klicken Sie auf der Erstellungsseite auf Projekt erstellen.
Wählen Sie eine Position für die Bereitstellung des Projekts aus.
Geben Sie einen Namen für das Projekt ein. Der Name muss für alle Projekte innerhalb der angegebenen Position eindeutig sein.
Wählen Sie die Ressourcengruppe aus, in der das Projekt erstellt werden soll.
Klicken Sie auf Erstellen.

Um die Dienstinstanz für die Projektressource anzuzeigen, gehen Sie zu Ihrem IBM Cloud Dashboard und suchen Sie Ihren Projektnamen in Code Engine.

Projekt über die Befehlszeilenschnittstelle (CLI) erstellen

Wenn Sie ein Projekt erstellen, wird es automatisch als aktueller Kontext ausgewählt. Verwenden Sie die Option --no-select, um ein Projekt zu erstellen, das nicht automatisch ausgewählt wird.

Installieren Sie die Code Engine-Befehlszeilenschnittstelle. Legen Sie die Ressourcengruppe als Ziel fest, die Sie für das Projekt verwenden möchten.
Erstellen Sie mit dem Befehl project create ein Projekt. Verwenden Sie einen Projektnamen, der in Ihrer Region eindeutig ist.
```
ibmcloud ce project create --name PROJECT_NAME
```
Beispielausgabe
```
Creating project 'myproject'...
OK
```

Stellen Sie mit dem Befehl project get sicher, dass das Projekt erstellt wurde.

ibmcloud ce project get --name PROJECT_NAME

Beispielausgabe

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

Sie können auch alle Projekte auflisten und in dieser Ausgabe wird angezeigt, welches Projekt Ihr ausgewähltes Projekt ist. Im folgenden Beispiel ist myproject das Projekt, das als aktueller Kontext ausgewählt ist.

ibmcloud ce project list

Beispielausgabe

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

Mit einem Projekt arbeiten

Nach dem Erstellen eines Projekts können Sie in der Code Engine-Konsole oder -Befehlszeilenschnittstelle mit dem Projekt arbeiten.

Mit einem Projekt in der Konsole arbeiten

Um mit einem Projekt zu arbeiten, gehen Sie auf die Seite Code Engine Projekte und klicken Sie auf den Namen des Projekts in der Liste.

Wenn Sie mit Code Engine-Komponenten arbeiten möchten, müssen Sie die Komponenten im Kontext eines Projekts verwenden. Im Kontext Ihres Projekts können Sie Code Engine-Komponenten wie Anwendungen, Jobs oder Funktionen erstellen und damit arbeiten. Anhand der Breadcrumb der Code Engine-Komponente können Sie das Projekt bestimmten, mit dem Sie derzeit arbeiten.

Mit einem Projekt über die Befehlszeilenschnittstelle (CLI) arbeiten

Damit Sie mit einem Projekt in der Befehlszeilenschnittstelle arbeiten können, muss das Projekt als aktueller Kontext ausgewählt werden. Ein Projekt wird bei der Erstellung automatisch als aktueller Kontext ausgewählt, es sei denn, die Option --no-select wird angegeben. Wenn Sie ein Projekt auswählen möchten, das derzeit nicht ausgewählt ist, verwenden Sie den Befehl project select.

ibmcloud ce project select --name PROJECT_NAME

Beispielausgabe

Selecting project 'myproject'...

Im Kontext des ausgewählten Projekts können Sie mit Code Engine-Komponenten wie Anwendungen, Jobs oder Funktionen arbeiten.

Als aktueller Kontext ausgewähltes Projekt bestimmen

Mit dem Befehl project current können Sie Details über das Projekt ermitteln, das als aktueller Kontext ausgewählt ist.

Projekt löschen

Wenn Sie ein Projekt nicht mehr benötigen, können Sie es löschen. Wenn Sie ein Projekt löschen, werden alle darin enthaltenen Komponenten gelöscht. Sie können hierzu die Konsole oder die Befehlszeilenschnittstelle verwenden.

Wenn Sie ein Projekt über die Konsole oder die Befehlszeilenschnittstelle (CLI) löschen, wird es soft gelöscht und kann wiederhergestellt werden. Ein Projekt muss innerhalb von 7 Tagen wiederhergestellt werden; andernfalls wird es dauerhaft gelöscht. Weitere Informationen zum Wiederherstellen von Projekten finden Sie unter Gelöschte Projekte wiederherstellen. Informationen zum dauerhaften Löschen eines Projekts finden Sie im Abschnitt Projekte permanent löschen.

Beim Löschen von Projekten zählen alle Projekte, die nicht dauerhaft gelöscht werden, zu den maximal 20 Projekten pro Region, die insgesamt zulässig sind.

Projektnamen innerhalb einer Region müssen eindeutig sein. Wenn Sie ein Projekt sanft löschen (oder das Projekt mit Reklamation löschen), können Sie den Projektnamen nicht wieder verwenden, bis das Projekt endgültig gelöscht ist.

Projekt in der Konsole löschen

Um ein Projekt aus der Konsole zu löschen, rufen Sie die Seite Code Engine Projekte auf, wählen das zu löschende Projekt aus und klicken auf das Löschsymbol. Wenn Sie ein bestimmtes Projekt öffnen, können Sie das Projekt auch über das Aktionsmenü löschen.

Wenn Sie ein Projekt in der Konsole löschen, dann wird das Projekt zunächst nur vorläufig gelöscht und kann innerhalb von 7 Tagen wiederhergestellt werden, bevor es dann dauerhaft gelöscht wird. Projektrückforderungen stellen gelöschte Projekte dar, die noch wiederhergestellt werden können. Auf der Seite Code Engine Projekte wird die Anzahl der Projektreklamationen angezeigt. Klicken Sie auf restorable projects, um die Seite Projektreklamationen zu öffnen und eine Liste der Projekte anzuzeigen, die wiederhergestellt oder endgültig gelöscht werden können.

Projekt über die Befehlszeilenschnittstelle (CLI) löschen

Wenn Sie ein Projekt löschen möchten, verwenden Sie den Befehl project delete. Mit der Option -f können Sie optional das Löschen eines Projekts ohne Bestätigung erzwingen. Nachdem ein Projekt soft gelöscht wurde, können Sie dieses Projekt mit den reclamation Befehlen verwalten. Im folgenden Beispiel wird das Projekt myproject vorläufig gelöscht:

ibmcloud ce project delete --name myproject -f

Beispielausgabe

Deleting project 'myproject'...
OK

Wenn Sie ein Projekt dauerhaft löschen wollen, sodass es nicht wiederhergestellt werden kann, geben Sie die Option --hard im Befehl project delete an. Mit der Option -f können Sie optional das Löschen eines Projekts ohne Bestätigung erzwingen. Im folgenden Beispiel wird das Projekt myproject1 permanent gelöscht.

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

Beispielausgabe

Deleting project 'myproject1'...
OK

Wenn Sie die Option --hard im Befehl project delete angeben, wird das Projekt sofort gelöscht und kann nicht mithilfe der IBM Cloud-Ressourcenrückforderung wiederhergestellt werden. Wenn Sie die Option --hard nicht angeben, kann das Projekt innerhalb von 7 Tagen mit dem Befehl reclamation restore wiederhergestellt werden.

Wenn Sie ein Projekt zuvor nur vorläufig gelöscht haben (also ohne Angabe der Option --hard ), dann können Sie eine nachfolgende Löschanforderung nur mithilfe des Befehls project delete unter Angabe der Option --hard angeben. Durch diese Aktion wird das Projekt vollständig gelöscht, sodass es nicht wiederhergestellt werden kann.

Gelöschte Projekte wiederherstellen

Gelöschte Projekte über die Konsole wiederherstellen

Nachdem Sie ein Projekt nicht permanent gelöscht haben, können Sie es über die Konsole wiederherstellen oder permanent löschen. Ein Projekt muss innerhalb von 7 Tagen wiederhergestellt werden; andernfalls wird es dauerhaft gelöscht.

Auf der Seite Projekte in der Konsole Code Engine können Sie die Liste der Projekte in Ihrer Region einsehen. Die Anzahl der Projektreklamationen wird angezeigt.
Klicken Sie auf den Link für project reclamations.
Ausgehend von der Seite Projektrückforderungen können Sie die Anzahl der verbleibenden Tage für die Wiederherstellung des Projekts einsehen.
- Um Ihr Projekt wiederherzustellen, klicken Sie auf das Wiederherstellungssymbol.
- Um Ihr Projekt dauerhaft zu löschen, klicken Sie auf das Löschsymbol.

Falls Sie für ein Projekt, das auf der Seite Projektrückforderungen aufgelistet ist, keine Aktion ausführen, wird das Projekt nach 7 Tagen automatisch permanent gelöscht.

Gelöschte Projekte mit der Befehlszeilenschnittstelle wiederherstellen

Vorläufig gelöschte Projekte können mit den reclamation-Befehlen verwaltet werden. reclamation-Befehle.

Mit dem Befehl reclamation list können Sie Projekte ermitteln, die nicht permanent gelöscht worden sind.

ibmcloud ce reclamation list

Beispielausgabe

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

Mit dem Befehl reclamation restore können Sie ein nicht permanent gelöschtes Projekt in einem aktiven Status wiederherstellen. Im folgenden Beispiel wird das Projekt myproject2 und seine Komponenten wiederhergestellt. Stellen Sie sicher, dass Sie als Ziel die richtige Region des Projekts angeben, das Sie wiederherstellen möchten.
```
ibmcloud ce reclamation restore --name myproject
```
Beispielausgabe
```
Restoring project 'myproject'...
OK
```

Alternativ dazu können Sie mit dem Befehl project restore ein nicht permanent gelöschtes Projekt in einem aktiven Status wiederherstellen.

Projekte permanent löschen

Projekte permanent aus der Konsole löschen

Nachdem Sie ein Projekt sanft gelöscht haben (oder das Projekt mit Reklamation gelöscht haben), können Sie es wiederherstellen oder dauerhaft aus der Konsole löschen. Wenn ein Projekt dauerhaft gelöscht wird, kann es nicht wiederhergestellt werden.

Auf der Seite Projekte in der Konsole Code Engine können Sie die Liste der Projekte in Ihrer Region einsehen. Die Anzahl der Projektreklamationen wird angezeigt.
Klicken Sie auf den Link für project reclamations.
Ausgehend von der Seite Projektrückforderungen können Sie die Anzahl der verbleibenden Tage für die Wiederherstellung des Projekts einsehen. Um Ihr Projekt dauerhaft zu löschen, klicken Sie auf Delete.

Wenn Sie keine Aktion für gelöschte Projekte durchführen, die auf der Seite Project reclamations aufgelistet sind, wird das Projekt automatisch nach 7 Tagen automatisch gelöscht.

Permanentes Löschen von Projekten mit der CLI

Wenn Ihr Projekt nicht permanent gelöscht worden ist, können Sie das Projekt mit dem Befehl reclamation delete permanent löschen. Durch die Verwendung der Option --force bei diesem Befehl wird der Löschvorgang ohne Bestätigung erzwungen.

ibmcloud ce reclamation delete -n myproject --f

Beispielausgabe

Hard deleting project 'myproject'...
OK

Falls für Ihr Projekt kein nicht permanenter Löschvorgang ausgeführt wurde, können Sie zum permanenten Löschen des Projekts (das seine Wiederherstellung verhindert) die Option --hard beim Befehl project delete verwenden und auf diese Weise angeben, dass das Projekt sofort und permanent gelöscht werden soll. Geben Sie beispielsweise Folgendes ein, wenn Sie das Projekt myproject3 permanent löschen möchten:

ibmcloud ce project delete --name myproject3 --hard

Beispielausgabe

Deleting project 'myproject3'...
OK