mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
91 lines
4.2 KiB
Plaintext
91 lines
4.2 KiB
Plaintext
:_mod-docs-content-type: ASSEMBLY
|
|
[id="working-with-projects"]
|
|
= Working with projects
|
|
include::_attributes/common-attributes.adoc[]
|
|
:context: projects
|
|
|
|
toc::[]
|
|
|
|
A _project_ allows a community of users to organize and manage their content in
|
|
isolation from other communities.
|
|
|
|
[NOTE]
|
|
====
|
|
Projects starting with `openshift-` and `kube-` are
|
|
ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
xref:../../authentication/using-rbac.adoc#rbac-default-projects_using-rbac[default projects].
|
|
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
ifdef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
default projects.
|
|
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
|
|
These projects host cluster components that run as pods and other infrastructure components. As such, {product-title} does not allow you to create projects starting with `openshift-` or `kube-` using the `oc new-project` command.
|
|
ifndef::openshift-dedicated[]
|
|
Cluster administrators can create these projects using the `oc adm new-project` command.
|
|
endif::openshift-dedicated[]
|
|
ifdef::openshift-dedicated[]
|
|
For {product-title} clusters that use the Customer Cloud Subscription (CCS) model, users with `cluster-admin` privileges can create these projects using the `oc adm new-project` command.
|
|
endif::openshift-dedicated[]
|
|
====
|
|
|
|
ifndef::openshift-dedicated[]
|
|
include::snippets/default-projects.adoc[]
|
|
|
|
endif::openshift-dedicated[]
|
|
ifdef::openshift-dedicated[]
|
|
[NOTE]
|
|
====
|
|
In {product-title} clusters that use the Customer Cloud Subscription (CCS) model, you cannot assign an SCC to pods created in one of the default namespaces: `default`, `kube-system`, `kube-public`, `openshift-node`, `openshift-infra`, and `openshift`. You cannot use these namespaces for running pods or services. You cannot create any SCCs for {product-title} clusters that use a Red Hat cloud account, because SCC resource creation requires `cluster-admin` privileges.
|
|
====
|
|
endif::openshift-dedicated[]
|
|
|
|
[id="working-with-projects-create-project"]
|
|
== Creating a project
|
|
|
|
You can use the {product-title} web console or the {oc-first} to create a project in your cluster.
|
|
|
|
include::modules/creating-a-project-using-the-web-console.adoc[leveloffset=+2]
|
|
|
|
// include modules/odc-creating-projects-using-developer-perspective.adoc[leveloffset=+2]
|
|
|
|
.Additional resources
|
|
|
|
* xref:../../applications/projects/working-with-projects.adoc#odc-customizing-available-cluster-roles-using-the-web-console_projects[Customizing the available cluster roles using the web console]
|
|
|
|
include::modules/creating-a-project-using-the-CLI.adoc[leveloffset=+2]
|
|
|
|
[id="working-with-projects-viewing-project"]
|
|
== Viewing a project
|
|
|
|
You can use the {product-title} web console or the {oc-first} to view a project in your cluster.
|
|
|
|
include::modules/viewing-a-project-using-the-web-console.adoc[leveloffset=+2]
|
|
|
|
include::modules/viewing-a-project-using-the-CLI.adoc[leveloffset=+2]
|
|
|
|
include::modules/odc-providing-project-permissions-using-developer-perspective.adoc[leveloffset=+1]
|
|
|
|
include::modules/odc-customizing-available-cluster-roles-using-the-web-console.adoc[leveloffset=+1]
|
|
|
|
include::modules/adding-to-a-project.adoc[leveloffset=+1]
|
|
|
|
[id="working-with-projects-viewing-project-status"]
|
|
== Checking the project status
|
|
|
|
You can use the {product-title} web console or the {oc-first} to view the status of your project.
|
|
|
|
include::modules/checking-project-status-using-the-web-console.adoc[leveloffset=+2]
|
|
|
|
include::modules/checking-project-status-using-the-CLI.adoc[leveloffset=+2]
|
|
|
|
// The following text comes from deleting-a-project-using-the-CLI.adoc
|
|
[id="working-with-projects-deleting-project"]
|
|
== Deleting a project
|
|
|
|
You can use the {product-title} web console or the {oc-first} to delete a project.
|
|
|
|
When you delete a project, the server updates the project status to *Terminating* from *Active*. Then, the server clears all content from a project that is in the *Terminating* state before finally removing the project. While a project is in *Terminating* status, you cannot add new content to the project. Projects can be deleted from the CLI or the web console.
|
|
|
|
include::modules/deleting-a-project-using-the-web-console.adoc[leveloffset=+2]
|
|
|
|
include::modules/deleting-a-project-using-the-CLI.adoc[leveloffset=+2]
|