2644cfef86
- move the section - replace identifiers with inline links - update settings (General settings > Advanced settings)
6 KiB
Projects
In GitLab, you can create projects for hosting your codebase, use it as an issue tracker, collaborate on code, and continuously build, test, and deploy your app with built-in GitLab CI/CD.
Your projects can be available publicly, internally, or privately, at your choice. GitLab does not limit the number of private projects you create.
Project's features
When you create a project in GitLab, you'll have access to a large number of features:
Issues and merge requests:
- Issue tracker: Discuss implementations with your team within issues
- Issue Boards: Organize and prioritize your workflow
- Multiple Issue Boards (EES/EEP): Allow your teams to create their own workflows (Issue Boards) for the same project
- Repositories: Host your code in a fully
integrated platform
- Branches: use Git branching strategies to collaborate on code
- Protected branches: Prevent collaborators from messing with history or pushing code without review
- Protected tags: Control over who has permission to create tags, and prevent accidental update or deletion
- Signing commits: use GPG to sign your commits
- Merge Requests: Apply your branching
strategy and get reviewed by your team
- Merge Request Approvals (EES/EEP): Ask for approval before implementing a change
- Fix merge conflicts from the UI: Your Git diff tool right from GitLab's UI
- Review Apps: Live preview the results of the changes proposed in a merge request in a per-branch basis
- Labels: Organize issues and merge requests by labels
- Time Tracking: Track estimate time and time spent on the conclusion of an issue or merge request
- Milestones: Work towards a target date
- Description templates: Define context-specific templates for issue and merge request description fields for your project
- Slash commands (quick actions): Textual shortcuts for common actions on issues or merge requests
GitLab CI/CD:
- GitLab CI/CD: GitLab's built-in Continuous Integration, Delivery, and Deployment tool
- Container Registry: Build and push Docker images out-of-the-box
- Auto Deploy: Configure GitLab CI/CD to automatically set up your app's deployment
- Enable and disable GitLab CI
- Pipelines: Configure and visualize
your GitLab CI/CD pipelines from the UI
- Scheduled Pipelines: Schedule a pipeline to start at a chosen time
- Pipeline Graphs: View your entire pipeline from the UI
- Job artifacts: Define, browse, and download job artifacts
- Pipeline settings: Set up Git strategy (choose the default way your repository is fetched from GitLab in a job),
timeout (defines the maximum amount of time in minutes that a job is able run), custom path for
.gitlab-ci.yml, test coverage parsing, pipeline's visibility, and much more
- GKE cluster integration: Connecting your GitLab project with Google Kubernetes Engine
- GitLab Pages: Build, test, and deploy your static website with GitLab Pages
Other features:
- Cycle Analytics: Review your development lifecycle
- Syntax highlighting: An alternative to customize your code blocks, overriding GitLab's default choice of language
Project's integrations
Integrate your project with Jira, Mattermost, Kubernetes, Slack, and a lot more.
New project
Learn how to create a new project in GitLab.
Fork a project
You can fork a project in order to:
- Collaborate on code by forking a project and creating a merge request from your fork to the upstream project
- Fork a sample project to work on the top of that
Project settings
Read through the documentation on project settings.
Import or export a project
- Import a project from:
- Export a project from GitLab
- Importing and exporting projects between GitLab instances
Transfer an existing project into a group
You can transfer an existing project into a group as long as you have at least Master permissions to that group and if you are an Owner of the project.
Find this option under your project's General settings > Advanced settings.
GitLab administrators can use the admin interface to move any project to any namespace if needed.
Project's members
Learn how to add members to your projects.
Leave a project
Leave project will only display on the project's dashboard when a project is part of a group (under a group namespace). If you choose to leave a project you will no longer be a project member, therefore, unable to contribute.