IBM Cloud Docs
Debugging projects

Debugging projects

Use the troubleshooting tips to learn how to troubleshoot Code Engine projects.

To understand how to create, work with, and delete projects, see Managing projects.

Project limits to consider

The maximum number of projects that you can create per region is 20. For more information about limits for projects, see Project quotas.

The maximum number of projects includes projects that are active and any projects that are not permanently deleted, such as projects that are soft deleted. A project that is soft deleted can be restored within 7 days before it is permanently deleted.

When working with the console, review your defined projects from the Projects page on the Code Engine console. This listing includes the region where your project lives. From this page, you can delete projects as needed. When you delete a project from the console, the project is soft deleted. The deleted project does not display from the Projects page.

When you are working with a component in Code Engine from the console such as apps, jobs, or functions, or their related entities such as access, bindings, or subscriptions, you can view details about the associated project. From the page of the particular Code Engine entity, click Details to learn more about the associated project. Use this page to view details of the associated project, which includes information such as the region, CRN (Cloud Resource Name), GUID (globally unique identifier), network addresses (public and private), and more!

When working with the CLI, use the project list command to display all your projects. The output of this command displays the region where your project lives.

Use the project delete command to delete a project. In the CLI, you can delete a project by specifying the name of the project or by specifying the project id. If you specify the --name of the project, you must be working in the same region where the project lives. If you specify the --id of the project, you are not required to be in the same project to issue the project delete command.

The following example command soft deletes the myproject project so that it can be restored within 7 days, ibmcloud ce project delete --name myproject -f. The -f option specifies to force the delete without confirmation. Note, this soft deleted project still counts toward the project maximum until the project is permanently removed 7 days later.

To permanently delete a project so that it cannot be restored, specify the --hard option with the project delete command, for example, ibmcloud ce project delete --name myproject2 --hard -f.

For more information, see deleting a project.