This GitHub Action is designed to streamline the CI/CD process for the Saagie Platform. It provides a set of customizable options to enhance your jobs and pipelines on the Saagie platform.

Before you begin:

• You must have a Saagie account with at least editor rights to the platform(s). For more information on access rights, see About Groups Page.
• You must have at least one project on your Saagie platform(s). For more information on how to create projects, see Creating Projects.

1. Create the following environment variables:

   • SAAGIE_URL: This is the URL of your Saagie platform.
   • SAAGIE_USER: This is the username of your Saagie account.
   • SAAGIE_PASSWORD: This is the password of your Saagie account.
   • SAAGIE_REALM: This is the DNS prefix determined when Saagie was installed. The Realm allows you to connect to your Saagie platform.

   They will be used to make the connection with your Saagie platform. For more information on how to create environment variables, you can see:

   Environment	Documentation Link
   GitHub	Creating configuration variables for a repository. 📝 Note: If you have password type variables, you must create them as secrets.
   Linux	Environment Variables
   Windows	Create and Modify Environment Variables on Windows
   Mac	Use environment variables in Terminal on Mac

2. Import the cicd_saagie_tool folder in your work directory, which includes the __main__.py, requirements.txt, and utils.py files.

3. Create a GitHub Action workflow file in your repository. For more information, see the GitHub documentation for Using workflows.

4. Add the following step to your workflow file:

   name: Saagie CICD
   
   on:
     push:
       branches:
         - main
   
   jobs:
     saagie-cicd:
       runs-on: ubuntu-latest
       steps:
         - name: Checkout Repository
           uses: actions/checkout@v2
   
         - name: Saagie CICD Action
           uses: <repository>/<action-name>@<release-tag>
           with:
             action: 'update'  # Available values: package_job, update_job, update_pipeline, update. Default: update
             saagie_url: ${{ secrets.SAAGIE_URL }}
             saagie_user: ${{ secrets.SAAGIE_USER }}
             saagie_pwd: ${{ secrets.SAAGIE_PASSWORD }}
             saagie_realm: ${{ secrets.SAAGIE_REALM }}
             saagie_env: 'dev' # Environment to connect to the Saagie Platform. It should be the same as the one in the env config files.
             job_config_folder: 'saagie/jobs/*.json'  # Folder where job config files are stored
             pipeline_config_folder: 'saagie/pipelines/*.json'  # Folder where pipeline config files are stored
             env_config_folder: './saagie/envs/*.json'  # Folder where env config files are stored
             job_source_folder: './code/jobs/*/*'  # Folder where job source code files are stored
             pipeline_source_folder: './code/pipelines/*.yaml'  # Folder where pipeline source code files are stored
             artefact_code_folder: './dist/*/*'  # Folder where artefact code files are stored

   Where the path to configuration and code files can be replaced with your own value.

   📝 Note: When using the package_job action, the zip file will be stored in the {artefact_code_folder}/{job_name} folder. The name of the zip file will be {job_name}.zip.

5. Make sure you have the required configuration and code files for each Saagie platform, job, and pipeline. For more information, see our template repository.

   📝 Note: The configuration files are stored in the saagie directory. The code files are stored in the code directory.

   📝 Note: For more information on the set up process, see CI/CD With Saagie Python API.

with:
  action: 'update'
  saagie_url: ${{ secrets.SAAGIE_URL }}
  saagie_user: ${{ secrets.SAAGIE_USER }}
  saagie_pwd: ${{ secrets.SAAGIE_PASSWORD }}
  saagie_realm: ${{ secrets.SAAGIE_REALM }}
  saagie_env: dev
  job_config_folder: 'saagie/jobs/*.json'
  pipeline_config_folder: 'saagie/pipelines/*.json'
  env_config_folder: './saagie/envs/*.json'
  job_source_folder: './code/jobs/*/*'
  pipeline_source_folder: './code/pipelines/*.yaml'
  artefact_code_folder: './dist/*/*'

This project is licensed under the MIT License - see the LICENSE file for details.