Variants

Yes - these are your tags!

Variants are the core elements of Orca.
Every variant will be used for one or more tags.

Depending on your Orca structure and your needs, a variant can also be a simple version of your image, which can be easily copy/pasted to a new version (folder) with only a few modifications in e.g. variables or blocks.
And then you have a completely new tag version.


How it works

We start with a basic variant for your Orca project.

Add a new folder in the "variants" folder or your project directory.
Now simply add a new Dockerfile and fill it with content.

  • 📁 variants
    • 📁 image
      • 📁 1.0
        • 📄 Dockerfile
Head over to your manifest.json and add a new entry for your variant folder.
After running Orca, you should see the generated sources for a new docker image with your created Dockerfile in the matching tag folder of the output directory.

That's it.

Now create a second file, e.g. "entrypoint.sh" and repeat the steps.
Your generated image should now have both files.

  • 📁 variants
    • 📁 image
      • 📁 1.0
        • 📄 Dockerfile
        • 📄 entrypoint.sh

Go ahead with creating a second variant, add it to the manifest.json and generate it again.

  • 📁 variants
    • 📁 image
      • 📁 1.0
        • 📄 Dockerfile
        • 📄 entrypoint.sh
      • 📁 2.0
        • 📄 Dockerfile
        • 📄 entrypoint.sh

I think you should now have a basic knowledge what it's all about.

Jump to