Project Developer

Documentation, best practices, and tutorials that are focused on making the most out of HPC resources via ECP CI enhancements. As such, information presented here is centered on those HPC-focused enhancements made to GitLab. We will make ample reference to GitLab’s official documentation and strongly encourage you to look there for details not covered in these pages. For any questions on runner or server deployment please see the administrator documentation.

Continuous Integration

Understanding the GitLab Runner is the key to making full use of the GitLab CI ecosystem. These sections are targeted not just at those unfamiliar with using the GitLab runner but anyone who wishes to understand how the ECP CI enhancements will affect their CI jobs.

• General CI Details
  • CI Job Token
  • CI Job Scheduling
• HPC Batch Executor
  • Batch Executors
  • Interactions with Default GitLab Behavior
  • Capturing CI Results
• Frequently Asked Questions
  • Error code processing
  • Specify where GitLab CI pipeline runs
  • Targeting multiple platforms

Guides

Guides are written to highlight general recommendations as well as potential workflows you may want to leverage when using CI resources leveraging ECP-specific enhancements.

Title	Description
Report Build Status to GitLab/GitHub	Leverage supported APIs in conjunction with a custom script to automate pipeline reporting to an upstream repository.
Multiple GitLab Project CI Structure	Optional configurations that can assist when managing GitLab CI/CD pipelines across multiple servers.
Artifacts, Caching, and Local Storage for HPC Projects	A generic look at the differences between artifacts, caching, and local storage for CI on test HPC resources.
Manual Directory Cleanup	Example job and resources that can assist in cleaning up stateful resources generated during CI.
Utilizing Scheduler Actions	Overview of the JACAMAR_SCHEDULER_ACTIONS configuration, deployment, and examples.

Tutorials

These tutorials aim to provide a look at how one might use upstream GitLab functionally coupled with the Jacamar CI enhancements and available test resources in a self-paced manner.

Title	Description
Empowering HPC Projects with Jacamar CI and GitLab	Learn how to run workloads within containers seamlessly using Jacamar’s container run mechanisms and develop strategies for optimizing operations for HPC projects.