Gestión de proyectos

Aprenda a crear proyectos y a trabajar con los mismos.

¿Qué es un proyecto?

Un proyecto es una agrupación de entidades de Code Engine, como aplicaciones, trabajos y compilaciones. Un proyecto se basa en un espacio de nombres de Kubernetes. El nombre del proyecto debe ser exclusivo en el grupo de recursos, la cuenta de usuario y la región de IBM Cloud®. Los proyectos se utilizan para gestionar recursos y proporcionar acceso a sus entidades.

Un proyecto proporciona los elementos siguientes.

Proporciona un espacio de nombres exclusivo para nombres de entidad.
Gestiona el acceso a los recursos del proyecto (acceso de entrada).
Gestiona el acceso a los servicios de respaldo, registros y repositorios (acceso de salida).
Tiene un certificado generado automáticamente para el Servicio de capa de transporte (TLS).

Para obtener más información sobre la gestión del control de acceso a proyectos con IAM, consulte Gestión del acceso de usuario.

Los proyectos no generan costes, sino que sirven como carpetas para tus aplicaciones, trabajos y funciones.

¿Cómo puedo ver los proyectos a los que puedo acceder?

Puede ver una lista de sus proyectos en la consola Code Engine.

También puede ejecutar el mandato project list.

ibmcloud ce project list

Salida de ejemplo

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

¿Cómo puedo ver detalles sobre un proyecto?

Desde la consola Code Engine, puede ver los detalles de un proyecto haciendo clic en el nombre de un proyecto de la página Code Engine Projects.

Cuando esté trabajando con un componente en Code Engine desde la consola, como aplicaciones, trabajos o funciones, o sus entidades relacionadas como accesos, enlaces o suscripciones, puede ver detalles sobre el proyecto asociado. Desde la página de la entidad Code Engine concreta, haga clic en Detalles para obtener más información sobre el proyecto asociado. Utilice esta página para ver detalles del proyecto asociado, que incluye información como la región, CRN (nombre de recurso de nube), GUID (identificador exclusivo global), direcciones de red (públicas y privadas), etc.

También puede ejecutar el mandato project get para visualizar detalles de un proyecto. Sustituya PROJECT_NAME por el nombre del proyecto. Si el proyecto está seleccionado como contexto actual, la salida de este comando incluirá detalles sobre los límites y el uso de cuotas de recursos de projecto de Code Engine. Para obtener más información sobre los límites para proyectos, consulte Cuotas de proyecto.

ibmcloud ce project get --name PROJECT_NAME

Salida de ejemplo

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

¿Cómo puedo definir políticas para que otros puedan trabajar con mi proyecto?

Consulte la información sobre cómo gestionar el acceso de usuarios para obtener información sobre el establecimiento de políticas de IAM para que otros puedan trabajar con su proyecto de Code Engine.

¿Hay límites de proyecto a tener en cuenta?

El número máximo de proyectos que puede crear por región es 20. Para obtener más información sobre los límites para proyectos, consulte Cuotas de proyecto.

Crear un proyecto

Puede crear un proyecto mediante la consola o con la CLI.

Creación de un proyecto desde la consola

En la página Proyectos de la consola Code Engine, haga clic en Crear. De forma alternativa, puede crear el proyecto al crear la app, trabajo o función de Code Engine con la vía rápida de la consola de Code Engine. En la consola deCode Engine, seleccione Vamos y pulse Crear proyecto en la página Empezar a crear.
Elija una ubicación para desplegar el proyecto.
Escriba un nombre para el proyecto. El nombre debe ser exclusivo para todos los proyectos dentro de la ubicación especificada.
Elija el grupo de recursos donde desea crear el proyecto.
Pulse Crear.

Para ver la instancia de servicio para el recurso del proyecto, vaya a su panel IBM Cloud y busque el nombre de su proyecto en Code Engine.

Creación de un proyecto con la CLI

Cuando cree un proyecto, se selecciona automáticamente como contexto actual. Para crear un proyecto que no esté seleccionado automáticamente, utilice la opción --no-select.

Instale la CLI de Code Engine. Elija como destino del grupo de recursos que desea utilizar para el proyecto.
Cree un proyecto con el mandato project create. Utilice un nombre de proyecto que sea exclusivo de la región.
```
ibmcloud ce project create --name PROJECT_NAME
```
Salida de ejemplo
```
Creating project 'myproject'...
OK
```

Verifique que el nuevo proyecto se ha creado con el mandato project get.

ibmcloud ce project get --name PROJECT_NAME

Salida de ejemplo

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

También puede listar todos los proyectos y esta salida muestra qué proyecto es el proyecto seleccionado. En el ejemplo siguiente, myproject es el proyecto seleccionado como contexto actual.

ibmcloud ce project list

Salida de ejemplo

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

Cómo trabajar con un proyecto

Después de crear un proyecto, puede trabajar con el proyecto mediante la consola de Code Engine o la CLI.

Cómo trabajar con un proyecto desde la consola

Para trabajar con un proyecto, vaya a la página Code Engine Projects y haga clic en el nombre del proyecto de la lista.

Para trabajar con los componentes de Code Engine, debe trabajar con los componentes en el contexto de un proyecto. Desde el contexto del proyecto, puede crear y trabajar con componentes de Code Engine como, por ejemplo, aplicaciones, trabajos o funciones. Para determinar el proyecto desde el que está trabajando actualmente, consulte el rastro de navegación del componente de Code Engine.

Cómo trabajar con un proyecto con la CLI

Para trabajar con un proyecto con la CLI, el proyecto se debe seleccionar como contexto actual. Un proyecto se selecciona automáticamente como contexto actual cuando se crea, a menos que se especifique la opción --no-select. Para seleccionar un proyecto que no esté actualmente como destino, utilice el mandato project select.

ibmcloud ce project select --name PROJECT_NAME

Salida de ejemplo

Selecting project 'myproject'...

Desde el contexto del proyecto seleccionado, puede trabajar con componentes de Code Engine como, por ejemplo, aplicaciones, trabajos o funciones.

Determinación del proyecto que se selecciona como contexto actual

Encontrará detalles sobre el proyecto que se ha seleccionado como contexto actual mediante el mandato project current.

Suprimir un proyecto

Cuando ya no necesite un proyecto, puede suprimirlo. Al suprimir un proyecto se suprimen todos los componentes que contiene. Puede utilizar la consola o la CLI.

Cuando se suprime un proyecto en la consola o con la CLI, se suprime de forma blanda y se puede restaurar. Debe restaurar el proyecto en un plazo de 7 días o se suprimirá de forma definitiva. Para obtener información adicional sobre la restauración de proyectos, consulte Restauración de proyectos suprimidos. Para suprimir permanentemente un proyecto, consulte Supresión permanente de proyectos.

Al suprimir un proyecto, los proyectos que no se supriman de forma permanente cuentan el máximo de 20 proyectos totales por región que están permitidos.

Los nombres de proyecto dentro de una región tienen que ser exclusivos. Cuando se suprime de forma blanda un proyecto (o se suprime un proyecto con reclamación), no se podrá reutilizar el nombre de proyecto hasta que este se suprima de forma permanente.

Supresión de un proyecto desde la consola

Para eliminar un proyecto de la consola, vaya a la página Code Engine Projects, seleccione el proyecto que desea eliminar y haga clic en el icono de eliminación. Si abre un proyecto específico, también puede suprimir el proyecto del menú Acciones.

Al suprimir un proyecto de la consola, el proyecto se suprime temporalmente y se puede restaurar en un plazo de 7 días antes de que se suprima de forma definitiva. Las reclamaciones de proyectos representan proyectos suprimidos que todavía pueden restaurarse. En la página Code Engine Projects, se muestra el número de reclamaciones de proyectos. Haga clic en restorable projects para abrir la página de reclamaciones de proyectos y visualizar una lista de proyectos que pueden restaurarse o eliminarse definitivamente.

Supresión de un proyecto con la CLI

Para suprimir un proyecto con la CLI, utilice el mandato project delete. Opcionalmente, puede utilizar la opción -f para forzar la supresión de un proyecto sin confirmación. Una vez borrado un proyecto, puede gestionarlo con los comandos reclamation comandos. En el siguiente ejemplo se suprime el proyecto myproject,

ibmcloud ce project delete --name myproject -f

Salida de ejemplo

Deleting project 'myproject'...
OK

Para suprimir de forma permanente un proyecto de modo que no se pueda restaurar, especifique la opción --hard con el mandato project delete. Opcionalmente, puede utilizar la opción -f para forzar la supresión de un proyecto sin confirmación. En el ejemplo siguiente se suprime permanentemente el proyecto myproject1,

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

Salida de ejemplo

Deleting project 'myproject1'...
OK

Si especifica la opción --hard con el mandato project delete, el proyecto se suprime inmediatamente y no se puede restaurar utilizando la reclamación de recurso de IBM Cloud. Si no especifica la opción --hard, el proyecto se puede restaurar en un plazo de 7 días utilizando el mandato reclamation restore.

Si previamente ha suprimido temporalmente un proyecto (sin especificar la opción --hard), puede especificar una supresión posterior solo utilizando el mandato project delete con la opción --hard. Esta acción suprime completamente el proyecto para que no pueda ser restaurado.

Restauración de proyectos suprimidos

Restauración de proyectos suprimidos desde la consola

Después de suprimir temporalmente un proyecto, puede restaurarlo o suprimirlo permanentemente desde la consola. Debe restaurar el proyecto en un plazo de 7 días o se suprimirá de forma definitiva.

En la página Proyectos de la consola Code Engine, consulte la lista de proyectos de su región. Se muestra el número de reclamaciones de proyecto.
Pulse en el enlace de project reclamations.
En la página Reclamaciones de proyecto, puede ver el número de días restantes que puede restaurar el proyecto.
- Para restaurar el proyecto, pulse en el icono de restauración.
- Para suprimir permanentemente el proyecto, pulse en el icono de suprimir.

Si no realiza ninguna acción en un proyecto que se lista en la página Reclamaciones de proyecto, el proyecto se suprime automáticamente de forma permanente después de 7 días.

Restauración de proyectos suprimidos con la CLI

Los proyectos que están suprimidos temporalmente se pueden gestionar con los mandatos reclamation. Mandatos reclamation.

Descubra los proyectos que se suprimen temporalmente utilizando el mandato reclamation list.

ibmcloud ce reclamation list

Salida de ejemplo

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

Utilice el mandato reclamation restore para restaurar un proyecto suprimido temporalmente a un estado activo. El ejemplo siguiente restaura el proyecto myproject2 y sus componentes. Asegúrese de que está dirigiéndose a la región correcta del proyecto que desea restaurar.
```
ibmcloud ce reclamation restore --name myproject
```
Salida de ejemplo
```
Restoring project 'myproject'...
OK
```

De forma alternativa, puede utilizar el mandato project restore para restaurar un proyecto suprimido temporalmente a un estado activo.

Supresión permanente de proyectos

Supresión permanente de proyectos en la consola

Después de suprimir de forma blanda un proyecto (o suprimirlo con reclamación), este se podrá restaurar o suprimir de forma permanente desde la consola. Cuando un proyecto se suprime de forma permanente, ya no se puede restaurar.

En la página Proyectos de la consola Code Engine, consulte la lista de proyectos de su región. Se muestra el número de reclamaciones de proyecto.
Pulse en el enlace de project reclamations.
En la página Reclamaciones de proyecto, puede ver el número de días restantes que puede restaurar el proyecto. Para suprimir permanentemente el proyecto, pulse Delete.

Si no realiza ninguna acción en los proyectos suprimidos que aparecen listados en la página Reclamaciones de proyecto, se suprimirán automáticamente y de forma permanente al cabo de 7 días.

Supresión permanente de proyectos con la CLI

Si el proyecto se suprime temporalmente, puede utilizar el mandato reclamation delete para suprimir el proyecto de forma permanente. Al utilizar la opción --force con este mandato, se fuerza la supresión sin confirmación.

ibmcloud ce reclamation delete -n myproject --f

Salida de ejemplo

Hard deleting project 'myproject'...
OK

Si el proyecto no se suprime temporalmente, para suprimir permanentemente un proyecto para que no se pueda restaurar, utilice la opción --hard con el mandato project delete para especificar la supresión inmediata y permanente del proyecto. Por ejemplo, para suprimir permanentemente el proyecto myproject3,

ibmcloud ce project delete --name myproject3 --hard

Salida de ejemplo

Deleting project 'myproject3'...
OK