A project allows a group of users to organize and manage their content in isolation from other groups.
Creating a Project
You can create a new project using the CLI or the web console.
To create a new project using the CLI:
$ oc new-project <project_name> \ --description="<description>" --display-name="<display_name>"
$ oc new-project hello-world \ --description="This is an example project" \ --display-name="Hello world"
The number of projects you are allowed to create is based on your subscription. Once your limit is reached, you may need to delete an existing project in order to create a new one.
When viewing projects, you are restricted to seeing only the projects you have access to view based on the authorization policy.
To view a list of projects:
$ oc get projects
You can change from the current project to a different project for CLI operations. The specified project is then used in all subsequent operations that manipulate project-scoped content:
$ oc project <project_name>
You can also use the web console to view and change between projects. After authenticating and logging in, you are presented with a list of projects that you have access to.
Checking Project Status
oc status command provides a high-level overview of the current project, with its components and their relationships. This command takes no argument:
$ oc status
Deleting a Project
When you delete a project, the server updates the project status to Terminating from Active. The server then clears all content from a project that is Terminating before finally removing the project. While a project is in Terminating status, a user cannot add new content to the project. Projects can be deleted from the CLI or the web console.
To delete a project using the CLI:
$ oc delete project <project_name>