Skip to main content
By default, every shop is delivered with its own GitLab repository. This repository is used to manage and version the layout and template files responsible for the appearance of the shop.

​
Access

The WEBSALE GitLab is available at the following URL: https://gitlab.websale.cloud The access credentials are provided when the shop is set up by WEBSALE AG.
Additional access for further users can be requested via WEBSALE AG’s commissioning portal.

​
Settings (Settings → CI/CD → Variables)

In the project menu under Settings → CI/CD → Variables, environment variables for the shop pipeline are defined.

​
Editable variables

Information about Type, Environment, Visibility Flags, and Key must not be changed for these variables. Changes to these settings can cause pipeline failures or errors.

​
Read-only variables

These variables can currently only be edited by WEBSALE AG employees.

​
Directory & file structure (root level)

By default, the repository contains the following entries at the root level:
  • media/ (directory)
  • templates/ (directory)
  • .gitlab-ci.yml (file)
  • README.md (file)

​
media

The media directory contains all static resources used for the design and layout of the shop. By default it is structured as follows:
Below the media/ directory, folders and files can be renamed, deleted, or newly created as needed. These changes are taken into account by the pipeline during deployment. When renaming or moving existing folders, the corresponding path references in templates, stylesheets, or scripts may also need to be adjusted so that resources continue to load correctly.

​
templates

The templates directory contains the template files relevant to the shop frontend. By default it is structured as follows:
Below the templates/ directory, folders and files can be renamed, deleted, or newly created as needed. These changes are taken into account by the pipeline during deployment. When renaming or moving existing folders, the paths used in the templates may also need to be adjusted so that the corresponding includes, layouts, and views can still be found.

​
gitlab-ci.yml

This file defines the CI/CD pipeline (Continuous Integration / Deployment) in GitLab. Default content
The file specified after remote: includes WEBSALE AG’s central pipeline template. This remote file can only be edited by WEBSALE AG.

​
How the WEBSALE pipeline works

The pipeline is triggered exclusively by commits to the main branch and runs the following jobs:
  1. Build (compile-sass)
  • Monitors changes in media/themes/default/scss/**
  • Compiles SCSS files to CSS (media/themes/default/styles/)
  1. Deploy (deploy-css)
  • Synchronizes the CSS directory with the corresponding S3 bucket
  • Certain subdirectories (e.g., fonts, scripts, favicons) are excluded
  1. Deploy (deploy-media-without-css)
  • Synchronizes the rest of the media folder (without the styles directory) with the S3 bucket
  1. Deploy (deploy-templates)
  • Transfers the templates directory to the S3 bucket
  • Optionally (depending on AUTO_COMPILE_TEMPLATES) performs template compilation via the shop’s API
The status of the pipeline and the log output of the individual jobs can be viewed in GitLab under Build → Pipelines.

​
README.md

File with additional information about the WEBSALE GitLab and the WEBSALE shop system.

​
Using your own version control

If you already have your own version control system that you would like to use for the development of the WEBSALE shop (e.g., GitHub, your own GitLab, or similar), this is generally possible. How it works
  • Development takes place as usual in your existing version control system.
  • Via your own pipeline (or manually via a Git remote), the relevant files are transferred to the corresponding WEBSALE GitLab project and pushed or merged into the main branch there.
  • From this point on, the pipeline stored in the WEBSALE GitLab project takes effect and handles build and deployment as usual (e.g., SCSS compilation, media and template deployment to S3).
The following prerequisites are required to push to the WEBSALE GitLab project:
  • A GitLab user for the relevant WEBSALE shop project with write permissions on the project or the main branch. The necessary access is provided by WEBSALE AG.
Using your own repository does not replace the setup of the WEBSALE GitLab project. The initial setup of the project and users currently cannot be done fully independently and is handled by WEBSALE AG for the time being.

​
Notes & limitations

  • The GitLab repository does not provide access to product data (e.g., products, prices, images) or customer data. Product and customer data can be managed via the Admin Interface, REST APIs, connectors, etc.
  • The repository is used for managing and deploying shop templates and the associated media files.
  • Custom processes such as Docker containers, additional build jobs, or external programs are not supported by the standard pipeline.
  • The standard pipeline currently only works on the main branch.
  • The deployment jobs only synchronize the media and templates directories. Folders created above these directories are not transferred.

​
Access to the object storage (S3)

GitLab only provides access to the shop templates or the theme/template repository. GitLab is therefore the central place for version control and editing the template code (e.g., adjustments to the frontend, layouts, components, styles). In addition to access via GitLab, there is also access to the shop’s object storage (S3). This access provides access to all files of the shop, e.g., product images, JSON files, etc.