Creating Kubernetes resources on the Research Computing Infrastructure

Students in select classes may create namespaces in the jup19-rke2-student cluster and deploy services in the *.kub.hpc.fau.edu domain. This guide will help you. 

1. Login to OwlCloud's Kubernetes infrastructure
2. Filter visibility to a project
3. Create a namespace
4. Create a deployment
5. Create an ingress (loadbalancer)
6. Visit a sample NGINX site.

To start the process:

Let us Login to OwlCloud

1. Visit https://jup19rancher.hpc.fau.edu
2. Click "Log in with Shibboleth" 
3. Login with your FAUNET ID and password
   
4. Click on the jup19-rke2-student cluster from the list. 
   

Now lets filter to a project

1. On the top of the page, you will see a drop-down to select your project/namespace. Click it.. and enter the namespace provided by your faculty sponsor or instructor and click the name.

Now lets create a namespace

1. Click Projects/Namespaces
   
2. Make sure you are in the correct view!!! This is critical
   
3. Click Create Namespace
   
4. Enter the namespace name this must be unique and meet some naming conventions so if you get an error read the error and make an adjustment.
   
    
5. Now select the project for your namespace. This must be the project for your class. 
    
6. Click Create 
7. If done correctly you will see your new namespace in the project
   

Now lets create a deployment and ingress

1. Click workloads and then deployments.
2. Click "Create" 
3. Verify the namespace is correct!
4. Now name your deployment (example nginx)
5. Specify your container image. (example nginx)
   
    
6. Networking needs to be setup to tell kubernetes that a TCP port is needed. (Example 80)
   Specify the Service type as Cluster IP, set the name to HTTP, and the port to 80.
   
    
7. Now click "Create"
8. Done!
   
    

Now let us create an ingress. This will help route requests to our deployed pods.

1. Click Service Discovery and then select ingress
2. Click Create
   
    
3. Specify a name (example nginx)
4. Specify the request host (something unique, example yournetid-example1.kub.fau.edu)
5. Specify the Path
6. From the drop down select the service and port (example: HTTP, 80)
   
    
7. Click create 
8. If everything worked the URL https://yournetid-test1.kub.hpc.fau.edu should load correctly. Make sure it is https! FAU Blocks http.