Contexts allow you to easily switch between multiple users across multiple
OpenShift Origin servers, or clusters, when using issuing CLI operations. Nicknames
make managing CLI configuration easier by providing short-hand references to
contexts, user credentials, and cluster details.
After logging in with the CLI for the first time,
OpenShift Origin creates a ~/.kube/config file if one does not
already exist. As more authentication and connection details are provided to the
CLI, either automatically during an
oc login operation or by
setting them explicitly, the updated
information is stored in the configuration file:
Example 1. CLI Configuration File
current-context: joe-project/openshift1.example.com:8443/alice (3)
- name: alice/openshift1.example.com:8443
clusters section defines connection details for OpenShift Origin clusters,
including the address for their master server. In this example, one cluster is
nicknamed openshift1.example.com:8443 and another is nicknamed
contexts section defines two contexts: one nicknamed
alice-project/openshift1.example.com:8443/alice, using the alice-project
project, openshift1.example.com:8443 cluster, and alice user, and another
nicknamed joe-project/openshift1.example.com:8443/alice, using the
joe-project project, openshift1.example.com:8443 cluster and alice user.
current-context parameter shows that the
joe-project/openshift1.example.com:8443/alice context is currently in use,
allowing the alice user to work in the joe-project project on the
users section defines user credentials. In this example, the user
nickname alice/openshift1.example.com:8443 uses an
After you are logged in, you can use the
oc status command or the
project command to verify your current working environment:
Example 2. Verifying the Current Working Environment
$ oc status
In project Joe's Project (joe-project)
service database (172.30.43.12:5434 -> 3306)
database deploys docker.io/openshift/mysql-55-centos7:latest
#1 deployed 25 minutes ago - 1 pod
service frontend (172.30.159.137:5432 -> 8080)
frontend deploys origin-ruby-sample:latest <-
builds https://github.com/openshift/ruby-hello-world with joe-project/ruby-20-centos7:latest
#1 deployed 22 minutes ago - 2 pods
To see more information about a service or deployment, use 'oc describe service <name>' or 'oc describe dc <name>'.
You can use 'oc get all' to see lists of each of the types described above.
$ oc project
Using project "joe-project" from context named "joe-project/openshift1.example.com:8443/alice" on server "https://openshift1.example.com:8443".
To log in using any other combination of user credentials and cluster details,
oc login command again and supply the relevant information during the
interactive process. A context is constructed based on the supplied information
if one does not already exist.
If you are already logged in and want to switch to another project the current
user already has access to, use the
oc project command and supply the name of
$ oc project alice-project
Now using project "alice-project" on server "https://openshift1.example.com:8443".
At any time, you can use the
oc config view command to view your current,
full CLI configuration, as seen in the above output.
Additional CLI configuration commands are also available for more
If you have access to administrator credentials but are no longer logged in as
system user system:admin, you can log back in as this user at any time as
long as the credentials are still present in your
configuration file. The following command logs in and switches to the default
$ oc login -u system:admin -n default