File Bundles

​

Upload new 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.
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 out the form:
   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 out the form.

​

Upload certificates

1. In Creator, select the base image and follow the wizard to the relevant step - upload files. Select Add File Bundle > Upload New.
2. Fill out the form:
   1. Provide a name and description for the custom configuration file. Adding a description is recommended as it is visible in the file bundle summary page.
   2. Select Type: Certificates.
   3. The file path is hardcoded and cannot be changed.
   4. Upload the certificate files.
   5. Save your changes.

​

Override configuration file

1. Before you begin, look up the default path to the configuration file in the base image. It may be listed in the specification tab in the Minimus console or you may need to run docker inspect on the image.
2. Save your custom configuration file and name it, preferably with a name that will help teammates understand its purpose.
   Validate that the files you plan to upload are not executable: chmod -x path/to/file
3. In Creator, select the base image and follow the wizard to the relevant step - upload files. Select Add File Bundle > Upload New.
4. Fill out the form:
   1. Provide a name and description for the custom configuration file. Adding a description is recommended as it is visible in the file bundle summary page.
   2. Select Type: Other.
   3. Provide the exact path you would mount the config file onto. For example in nginx, the path would be /etc/nginx. See also our nginx tutorial
   4. Upload the file.
   5. Save your changes.

​

Edit file bundle

• 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.