Creating a repository in SourceCraft

A repository is a storage containing the entire codebase of your project and information related to it. A repository includes:

  • Source code (all project files)
  • Change history (commit log)
  • Branches (independent development lines)
  • Tags (markers for key points in the project’s history)

You can use a repository to track the progress of your project, manage different development branches, and roll back to previous code versions.

SourceCraft uses branch policies for change management and code review, enforcement of proper naming conventions and branch and tag conditions, and protection of branches from accidental commits or direct pushes.

The following options are available for creating a repository:

Creating a blank repository

  1. Open the service home page.
  2. In the left-hand panel, click Create repository.
  3. In the window that opens, select Blank repository.

  4. Under Your new repository details:

    • In the Owner field, select the organization to create the repository in.

    • In the Name field, specify a name for the repository.

      The name must be unique within the organization. The name may contain the following ASCII characters: lowercase and uppercase Latin letters, numbers, commas, hyphens, and underscores.

      The address to access the repository at is displayed below the name.

    • Optionally, in the Description field, enter a description for the repository.

  5. In the Visibility field, select the repository access type:

    • Private: Only invited users will have access to view and edit the repository.

    • Public: All internet users will be able to view the repository without authentication. Only invited users will be able to modify the repository.

      Warning

      SourceCraft is publicly available to everyone at the Preview stage. Therefore, all internet users can view public repositories without authentication.

    You can change repository access type at any time.

  6. Optionally, under Configuration, select:

    • Initialize repository with a README: To add the README.md project description file to the repository.

    • Add .gitignore: To add to the repository the .gitignore file listing the files to be ignored by git.

      To use templates for .gitignore:

      • Expand the drop-down list.
      • In the search bar , enter the programming language or framework you want to use for development.
      • Select all suitable templates one by one.

    • Add a license: To add the LICENSE project license file to the repository.

      To use a template for LICENSE:

      • Expand the drop-down list.
      • In the search bar , enter the license name.

    • Add a CI/CD template: To add the .src.yaml CI/CD configuration file to the repository.

      To use a template for .src.yaml, expand the drop-down list and select the appropriate CI/CD configuration.

      For more information on CI/CD, see Configuring CI/CD in a SourceCraft repository.

  7. Click Create repository.

Creating a repository from a template

  1. Open the service home page.
  2. In the left-hand panel, click Create repository.
  3. In the window that opens, select Blank repository.

  4. Under Your new repository details:

    • In the Owner field, select the organization to create the repository in.

    • In the Name field, specify a name for the repository.

      The name must be unique within the organization. The name may contain the following ASCII characters: lowercase and uppercase Latin letters, numbers, commas, hyphens, and underscores.

      The address to access the repository at is displayed below the name.

    • Optionally, in the Description field, enter a description for the repository.

  5. Under Repository template, click Browse templates, select suitable repository template, and click Use template.

    Templates contain a preinstalled CI/CD configuration and standard project files.

    To view the template contents, click Preview.

  6. In the Visibility field, select the repository access type:

    • Private: Only invited users will have access to view and edit the repository.

    • Public: All internet users will be able to view the repository without authentication. Only invited users will be able to modify the repository.

      Warning

      SourceCraft is publicly available to everyone at the Preview stage. Therefore, all internet users can view public repositories without authentication.

    You can change repository access type at any time.

  7. Click Create repository.

See also

Previous
All guides
Next
Importing or mirroring a repository