Docs

# Create a config branch in your git repository

Creating a config branch in your git repository will be explained in detail later in this guide.

For now, we will initialize an empty git branch named config to be able to create a Config repository

git checkout --orphan config
git rm -rf .
touch .gitignore
git add .gitignore
git commit -m "Init config branch"
git push origin config
git checkout stacks
1
2
3
4
5
6
7

Then, you need to add a Config repository on Cycloid. To match the default sample value, please use

  • step-by-step-cr as name
  • your git repository SSH URL as URL
  • ssh_key as credential
  • config as branch

Private config repository

# Create a project with a private catalog

Previously, we created a stack in a stacks branch of your private git repository. Now we will see how to define it on the Cycloid console to create a project from it in your organization.

Start to add a private catalog repository following the Catalog repository documentation. To match the default sample value, please use

  • step-by-step as name
  • your git repository SSH URL as URL
  • ssh_key as credential
  • stack as branch

Private catalog repository

After configuring the private service catalog, let's create a new project called Snowy with a Test environment.

  1. Go on Cycloid's dashboard and click on Projects / Create a new project

  2. Enter the name Snowy and select the Config repository you created earlier

Project creation

  1. Your new private stack should be available in the stack list by looking for stack-sample keyword, select it by clicking on Use this stack

Stack

  1. You now have the choice to create an environment. Specify the Test environment and click Next

Environment creation

  1. The wizard should now display the pipeline and the variables to use from the variables.sample.yml file. Configure those variables with your own values

Create project

  1. Move on to the last step of the wizard and click on the Run button

Run project

Congrats! You created a project using your own stack. In the next steps, we will go a little bit further to improve the pipeline by adding jobs.

# Key points to remember

  • To create a Cycloid project you must first create a Config repository
  • To use a private stack on a Cycloid project, you need to create a private Catalog repository, which contains your stack
  • You need to create at least one environment to finalize the creation of a Cycloid project

← Step 3 - Introduce Terraform →