Skip to content

Accessing the Cluster

Pre-requisites

To access the jax-cluster-* resources, you will first need to have set up GCP access as described in the Google Cloud overview page.

You will also need to downlaod the gcloud and kubectl command line tools, as described in the Development Environement set up documentation.

Login to GCP

Once you have installed these tools, you can authenticate with GCP by running the following command:

Make sure to log in with you @jax.org account!

gcloud auth login

You can verify that you are logged in by running the following command: 

gcloud auth list

Access Level

You will have viewer access to each of the three jax-cluster-* projects:

  • jax-cluster-sandbox-10 - Sandbox cluster for testing and experimentation.
  • jax-cluster-dev-10 - Development cluster for development and testing.
  • jax-cluster-prod-10 - Production cluster for running applications.

You will only have editor access to the jax-compsci-nc-dev-01 project. By default, you will only have the Kubernetes Enginer Developer role, which will give you access to make changes to cluster level resource. If you need access to make changes to the project level resources, you will need to contact the SQA team, or open a Pull Request to the terraform-prod repository.

Authenticate to The Cluster

You can then authenticate with the kubernetes cluster by running the following command:

gcloud container clusters get-credentials jax-cluster-dev-10 \
    --region us-east1 \
    --project jax-compsci-nc-dev-01

You can verify that you are connected to the cluster by running the following command: 

kubectl get nodes

Artifact Registry

You will also need access to the artifact registry. Anyone with an @jax.org account should have access to the -dev docker artifact registry. You can check this by running the following command: 

gcloud artifacts docker images list \
    us-east1-docker.pkg.dev/jax-cs-registry/docker-dev  \
    --limit=5

For more information on the artifact registry, see the Artifact Registry overview page and the Artifact Registry tutorials.

Using the Cloud Console

You can also access the cluster through the Google Cloud Console.

In the upper left hand corner of the page, select the project name box next to "Google Cloud". That will open a dialogue box where you can select one of the projects listed above.