README.md

Cern FTS Image (Modified)

Slightly modified container image for Cern's FTS project.

Image Tags

• X.Y.Z: A specific version of FTS.

See OSG Harbor for a complete listing.

How to Build

This image is built by GitHub any time a commit is made and tagged. But if you need to build the image on your own locally, do the following:

1. Install Podman or Docker.

   • In the commands below, podman may be interchanged with docker depending on your choice.

2. cd into the directory containing this repository.

3. Build the image:

   podman build --file Containerfile --tag fts-server:local .   

How to Use

1. Install Podman or Docker.

   • In the commands below, podman may be interchanged with docker depending on your choice.

2. Pull this image from OSG Harbor (or use the image you built above fts-server:local):

   podman pull hub.opensciencegrid.org/slate/fts-server:X.Y.Z

3. Perform an action in the container.

How to Contribute

NOTE: Several versions of FTS are concurrently supported.

1. To contribute to vX.Y**, check out the matching releases/X.Y branch.
   • If releases/X.Y does not yet exist, create it by branching off master.
2. Complete the desired edits, commit, and push to GitHub's upstream releases/X.Y branch.
3. Verify the resulting Checks (Image) GitHub Action completes successfully (Dockle & Trivy).
4. If the checks pass, apply a Git tag with a v prefix and push to GitHub. For example:
   • v1.0.1 -- resulting image will be tagged with latest, 1.0, and 1.0.1
   • v3.12.5-pre.20230308-1948 -- resulting image will be tagged with 3.12.5-pre.20230308-1948
   • v3.12.5-test-20230308-1930 -- resulting image will be tagged with 3.12.5-test-20230308-1930
   • vMyTestTag -- resulting image will be tagged with MyTestTag
5. At this point the Release GitHub Action will trigger to build, check, and deploy the resulting image to OSG Harbor.

Resources

• Cern: fts3.