Guides

Creating a Project

Suggest Edits

How to create a Project?

  1. To create a new Project, navigate to the Projects tab and click Create Project.
  2. In the modal that appears, mention

    1. Enter Project Name and Description

    • Enter the Project Name and an optional Description.
    • The description will appear alongside the project name in the project cards on the project overview page.

    2. Choose Git Account for Repository Creation

    • Select a Git Account to create the repository for the project.
    • The repository will store the project’s blueprint and Terraform modules, making them accessible outside the UI.
    • If you haven’t created an account yet, follow these steps.
    • You can also select a different organization account if you prefer not to use your personal account.

    3. Choose Project Type

    • Select a Project Type to use a pre-configured blueprint template with the necessary settings for your project.
    • You can also create custom project templates in the Ops Center for use in future projects.

    4. Select Allowed Cloud Provider

    • Select the Allowed Cloud provider to determine the cloud environment where your project will be hosted.
    • This selection filters the blueprint resources and applies default configurations, or "flavors," tailored to the chosen cloud provider.

    5. Select the Type of Environments

    • Choose the type of Environments you want to create for your project (e.g., Development, Staging, Production).
    • These environments will be created in the UI but must be launched to provision them in the cloud.

6. Click Create

  • You have successfully created a new Project. This will be accessible from the Projects tab.

Sample Product Demo


Import Existing Project/Repo

When creating a new project in Facets, you can choose to import from an existing Git repository instead of generating a fresh codebase. Facets will link to your repository and treat it as the source of truth for this project’s infrastructure.

This option is available inside the Create Project modal.

So when you toggle the field "Import Project" it will expose you some additional fields-

  1. Git URL*
    Here you need to enter the full URL of the Git repository that contains your existing code.
    Example: https://github.com/Facetscloud/sample-infra

  2. Git Ref*
    Here you need to provide the specific branch name or commit ID you want to use.
    Example: main or c4e8d1a

  3. Relative Path*
    Finally specify the path to the exact folder where your project code lives within the repo.
    Example: modules/aws/s3

Note: These fields are mandatory. Facets will only import and link to the specified subfolder within the given ref.

Once saved, Facets uses this location as the live project source and integrates it into its orchestration engine without creating a new scaffolded repo.

Updated 10 days ago