Projects

Create a project

Ruby

group = create(:group, name: 'My Group')
create(:project, :public, creator: @owner, namespace: group)

Yaml

groups:
  - _id: my_group
    name: My Group

projects:
  - creator_id: "<%= @owner.id %>"
    namespace_id: "<%= my_group.id %>"
    traits:
      - public

Json

{
  "groups": [
    "_id": "my_group",
    "name": "My Group"
  ],
  "projects": [
    "creator_id": "<%= @owner.id %>",
    "namespace_id": "<%= my_group.id %>",
    "traits": [
      "public"
    ]
  ]
}

Tip

You can change the visibility of the project by using one of the :public, :internal, or :private traits.

Project Visibility

The visibility of a project can be determined by the visibility_level attribute.

Create a project with Merge Trains

create(:project, :public, creator: @owner, namespace: @group) do |project|
  project.update(merge_pipelines_enabled: true, merge_trains_enabled: true) # enable merge trains
end

Create a project with a custom Git repository

You can create a project with a custom Git repository by passing a hash of filename → content to the files transient attribute.

The below will create two commits to a Project with two files in the foo directory with their respective content.

# Hash of filename → content. One commit per-file
files = {
  'foo/a.txt' => 'foo',
  'foo/b.txt' => 'bar'
}

create(:project, :custom_repo, creator: @owner, namespace: @group, files: files)

Create a project with a pre-populated repository

By specifying the :repository trait, you can create a project with a pre-populated repository.

The repository that will be populated is located here: https://gitlab.com/gitlab-org/gitlab-test

create(:project, :repository, creator: @owner, namespace: @group)

Gotchas

Owner

You must pass the owner attribute to the factory. Unless your seed file is creating a user, this will usually be set to the @owner global variable. create(:project, owner: @owner)

Top-level namespaces

By default, projects are supposed to create their top-level namespaces. Unfortunately this is a bit hit-and-miss.

You must pass the namespace attribute to the factory