Project
SkyU is a platform that helps you manage your Kubernetes applications and environments. In SkyU, you can create a project to manage your applications, environments and secrets.
A Project in SkyU is always associated with a GitHub repository. This repository is used for GitOps and is managed by SkyU. You can also use your own repository for GitOps. You can learn more about GitOps in the GitOps section.
Create a Project
You can create a project by clicking on the Create Project button on the SkyU Console.
General Details
Fill the following details with appropriate information.
| Field | Description | Example |
|---|---|---|
| Name | Name of the Project. This has to be unique across your organization and should not contain special characters. | test-project |
| Description | Provide a meaningful description for your project | this is a test project |
Authenticate
Authenticate with GitHub to create a new repository or select an existing repository for GitOps.
This step will route you to the GitHub OAuth page where you can authenticate with your GitHub account and install the SkyU GitHub App to create a new repository or select an existing repository for GitOps.
For most Projects, Create New would be the ideal option where SkyU will generate a new GitHub repository to GitOps
Configure GitOps
Configure the GitOps repository with the following details.
| Field | Description |
|---|---|
| Github Account | Your Github Organization / Account |
| Repository | The name of the repository which skyu would automatically create for you |
| Branch | Default branch for the repository |
You can learn more about GitOps in the GitOps section.
Configure Secrets Store
In this step, you have the options to select the preferred secret manager for your project.
Secret store is used to store sensitive information like API keys, passwords, configs etc in your project which cannot be committed into the gitops repository. You can choose between the SkyU Secret Manager or a Dedicated Secret Manager.
| Secret Store | Description |
|---|---|
SkyU Secret Manager | Shared secret manager provided by SkyU. This is good for startups and testing demo projects |
Dedicated Secret Manager. | Dedicated Secret Manager lets you bring a secret manager you own from your infrastructure. |
Dedicated Secret Manager
Currently AWS Secret Manager is the only supported secret store. More stores will be supported soon.
| Field | Description |
|---|---|
| Account ID | Your AWS Account ID. Please ensure that it matches the account ID your log into |
| Region | Region of your AWS Secret Manager |
| Role ARN | Automatically filled. |
Once you fill the details, click on Create Role on AWS to create the role in your AWS account.
Make sure you are logged into your AWS console in a different tab in the same browser window before clicking the Create Role on AWS button.
You can also migrate from the SkyU Secret Manager to a dedicated secret manager later on as well. This is a one time process where all secrets stored in the SkyU Secret Manager will be migrated into your Dedicated Secret Manager.
Create Environments
This step can be used to configure the different Environments needed for the project. While you can proceed with the defaults, you can also proceed without environments.
Namespace is the main namespace for the environment. You can also add additional namespaces for the environment. This is derived from the context of Kubernetes. But if you are not working with Kubernetes, you can proceed with the default namespaces.
Clusters are not created during project creation. You can always add clusters to the environments later on.
At least one Environment is needed to create an application in SkyU. If you did not configure Environments during project creation, you can always create new environments from the Environments tab in the SkyU console Aside Menu.
Verify and Create
You can use this step to finalize the Project creation, Continue or Go back.
