Skip to main content
File bundles are used to include public keys for internal PKIs (Public Key Infrastructure certificates) as well as config files. File bundles are always centrally managed and automatically versioned on change.
If certificates are included, they are implicitly trusted by the image without any need to perform any additional actions after pulling the image.
File Repository

​
Upload new bundle

There are two ways to upload a new file bundle:
  • You can add a new file bundle directly to the file repository when you are not actively creating or editing a private image.
  • You can upload a new file bundle directly to a private image as part of the Creator flow. The file bundle will be added to the central file repository automatically and will be available for selection for other private images as well.

​
Upload from file repository

  1. Select Creator in the main menu.
  2. Select the option to Manage Files. Manage Files
  3. The file repository will be listed with your existing file bundles. You can search the list by bundle name or description and filter by bundle type: certificates or other.
  4. Select the option to upload new bundle.
  5. Fill the form: Upload certificate
    1. Provide a name and description (The description is optional but recommended for search purposes).
    2. Select the bundle type and path: Certificates or Other.
      Note that certificates must be uploaded to a file bundle type of Certificates. They cannot be uploaded to the bundle type Other.
    3. If you select Certificates, the folder path is hardcoded: /usr/local/share/ca-certificates/
    4. If you select Other, the folder path is configurable. Specify an absolute Linux path starting with / and without backslashes \).
  6. Upload valid files.
    1. A maximum of 20 files can be uploaded per file bundle.
    2. File size is limited to 1 MB per file.
  7. Save your changes. The new file bundle will be added to the list in your file repository.

​
Upload directly to private image

  1. Select Creator in the main menu.
  2. Select the option to Create private image.
  3. Follow the wizard to the fourth step - Upload files.
  4. Select Add File Bundle > Upload New.
  5. Continue from step 5 above to fill the form.

​
Edit file bundle

Go to your file repository, hover over a file bundle card to select the edit option.
  • Once the bundle is updated, Minimus will automatically build new versions of all private images that include the file bundle.
  • Visit the image changelog to view the new image digest in context.

​
Remove or delete file bundle

  • To remove a file bundle from a private image, go to Creator to edit the private image. Once saved, the private image will be rebuilt with the relevant changes.
  • To delete a file bundle from the file repository, first remove it from all private images. A file bundle cannot be deleted as long as it is referenced by a private image.

​
Limitations

  • The maximum number of file bundles allowed by the file repository is 50.
  • The maximum number of file bundles allowed per private image is 10.
  • The maximum number of files per bundle is 20.
  • The maximum file size is 1 MB per file.