Step 1: Create a Project on GitLab
Log in to your GitLab account.
On the GitLab main interface, you'll find a New Project
button or a "+" icon in the top-right corner. Click on it to create a new project.
Step 2: Create the .gitlab-ci.yml
File
After creating the project, access the project's page.
In the left-hand menu, choose "Repository
to open the source code management tab.
Click on the New file
button to create a new file and name it .gitlab-ci.yml
.
Step 3: Configure .gitlab-ci.yml
for a Basic CI/CD Workflow
Here's an example of a .gitlab-ci.yml
file with specific steps for a CI/CD workflow:
stages:
- build
- test
- deploy
build_job:
stage: build
script:
- echo "Building the application..."
# Add steps to build the application, e.g., compile, build artifacts, etc.
test_job:
stage: test
script:
- echo "Running tests..."
# Add steps to run automated tests, e.g., unit tests, integration tests, etc.
deploy_job:
stage: deploy
script:
- echo "Deploying the application..."
# Add steps to deploy the application, e.g., deploy to staging/production servers.
# Configuration to deploy only on changes to the master branch
only_master:
only:
- master
Step 4: Trigger CI/CD on GitLab
When you push code to the repository on GitLab (e.g., add, modify, or delete code files), GitLab will automatically initiate the CI/CD process based on the .gitlab-ci.yml
file.
Each stage (build
, test
, deploy
) will run sequentially, performing the defined jobs.
Step 5: View CI/CD Results
In the project's GitLab page, select the "CI/CD" tab to view all the executed CI/CD jobs.
You can see the run history, timings, outcomes, and in case of errors, error notifications will be displayed here.
Note: This is a simple example. In reality, CI/CD workflows can be more complex and involve multiple steps like security checks, performance testing, integration testing, and more. You'll need to delve deeper into configuring and customizing GitLab CI/CD for your project's needs.