Known Issues and Limits
Issues​
No known critical issues at this time. Please see our GitHub Issues for more information...
Hauler- https://github.com/hauler-dev/hauler/issuesHauler Helm- https://github.com/hauler-dev/hauler-helm/issuesHauler Docs- https://github.com/hauler-dev/hauler-docs/issues
Limitations​
Limitation for Hauler Store Load​
- When loading a
podmangeneratedtarballwithhauler store load -f <podman tar>it may fail to load all of the images contained intarball. Please note that at this time this is not supported, but may change in the future.
Limitation for Hauler Store Copy​
- When copying artifacts from your
storeto a specific path on an existing and authenicated registry usinghauler store copy, you first must usehauler login, without the<path>, only the<registry-url>. Please see the example below...
hauler login <registry-url> --username <username> --password <password>
hauler store copy registry://<registry-url>/<path>
Limitation for Helm Chart Names​
Haulermay error when fetching a helm chart when using astorewith the same name of thehelm chart.- For example, if you tried to use a custom
storename ofrancherwhen fetching ahelm chartnamedrancher, it will fail due to the fact thathelmdefaults to fetching charts from an exisiting local directory. - https://github.com/helm/helm/blob/main/pkg/action/install.go#L730-L831
- For example, if you tried to use a custom
Limitation for Hauler Temp Directory​
Haulerwill default to write temporary directories and files to/tmp. If you do not have the same (or more) amount of space available in your/tmpcompared to the size of thestoreorhaul, thenhaulermay error.- Recommendation: Ensure there is enough space availabe in
/tmpor change the default temporary directory with--tempdir, before running the commandhauler store load --filename haul.tar.zst.
- Recommendation: Ensure there is enough space availabe in
Notices​
In Hauler v1.4.0...​
- Added a notice to
hauler store sync --products/--product-registryto warn users the default registry will be updated in a future release.- Users will see logging notices when using the
--products/--product-registrysuch as... !!! WARNING !!! [--products] will be updating its default registry in a future release...!!! WARNING !!! [--product-registry] will be updating its default registry in a future release...
- Users will see logging notices when using the
In Hauler v1.2.0...​
- Upgraded the
apiVersiontov1fromv1alpha1- Users are able to use
v1andv1alpha1, butv1alpha1is now deprecated and will be removed in a future release. We will update the community when we fully deprecate and remove the functionality ofv1alpha1 - Users will see logging notices when using the old
apiVersionsuch as... !!! DEPRECATION WARNING !!! apiVersion [v1alpha1] will be removed in a future release...
- Users are able to use
- Updated the behavior of
hauler store loadto default to loading ahaulwith the name ofhaul.tar.zstand requires the flag of--filename/-fto load ahaulwith a different name - Users can load multiple
haulsby specifying multiple flags of--filename/-f- updated command usage:
hauler store load --filename hauling-hauls.tar.zst - previous command usage (do not use):
hauler store load hauling-hauls.tar.zst
- updated command usage:
- Updated the behavior of
hauler store syncto default to syncing amanifestwith the name ofhauler-manifest.yamland requires the flag of--filename/-fto sync amanifestwith a different name - Users can sync multiple
manifestsby specifying multiple flags of--filename/-f- updated command usage:
hauler store sync --filename hauling-hauls-manifest.yaml - previous command usage (do not use):
hauler store sync --files hauling-hauls-manifest.yaml
- updated command usage: