HowTo:CS Launch
Introduction
This is a quick start guide for using the CS Launch website and kubernetes resources. It will walk you through setting up a basic website with database support. The first half showing using the web interface, and the second half shows how to do it through a command line interface.
Create a New Project
Access to CS Launch is made through projects. A project is a collection of kubernetes namespaces and resources. You can have access to multiple projects. Projects can be shared with other CS members. The default kubernetes cluster Endeavour only allows Faculty and Staff to create projects. After a Faculty member creates a project, it can be shared with CS students.
- Go to CS Launch website: https://launch.cs.vt.edu
- Click the login button to use your CS username and password to log in
- The main screen will show a list of kubernetes clusters you have access to, if the list is blank then you don't have access to any clusters
- Click on the cluster name where you want to create the new project
- This is your cluster dashboard
- From the menu on the left Click on Projects/Namespaces
- Click on the Create Project button
- Fill in the Name field with a cluster unique name for your project
- You add additional project members now or later after the project is created
- Click on the Create button
Create a New Namespace
Kubernetes uses namespaces to separate resources. The CS Launch resources groups namespaces into projects for access control. A project can contain multiple namespaces. At least one namespace is required before resources can be created in a project. To access a namespace you must be a member of the project the namespace is associated with. A namespace can only be associated with a single project.
- Navigate to the list of projects
- Click on Projects/Namespaces from the cluster dashboard
- Click on the Create Namespace button that is associated with the project you want to assign the namespace to
- Fill in the Name field with a cluster unique name. The namespace name can be the same as the project name as long as it follows the naming rules and is not already in use. Kubernetes namespace names must following DNS name rules: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#dns-label-names