Each time a component's artifacts are imported into the repository, including the first time, a separate version is stored in CodeStation. Versions can be assigned automatically by HCL™ Launch, applied manually, or come from a build server.
Every time a component's artifacts are modified and imported, a new version of the component is created and an entry is made in the Component Version Import log. So a component might have several versions in CodeStation, and each version is unique.
Note: By default, the component version import log is cleaned up every 24 hours. Only the most recent 100 entries are maintained in the log after cleanup.
Artifacts can be imported automatically or manually. By default, a complete copy of an artifact's content is imported into CodeStation. When you copy the artifact to CodeStation, the original artifact content is never modified.
A version can be full or incremental. A full version contains all component artifacts; an incremental version contains only artifacts that are different from the previous version. When performing an incremental import you only need to upload only the changed artifacts. Artifacts that are the same as the base version do not need to be uploaded.
Storing artifacts in CodeStation provides several benefits, such as tamper-proof storage, and the ability to review and validate artifacts with the HCL Launch user interface. But if you have storage concerns or use a tool like Maven, you can limit CodeStation to using references to the artifacts instead of copying them into CodeStation.
Note: Do not give component versions the name
newest. These names are reserved to represent the most recently created version for certain CLI commands, including requestApplicationProcess and createSnapshot. You cannot use these keywords to represent component versions in the web interface.
- Tracking environment inventory for components
You can track the environment inventory for each component by clicking the component and then going to the Usage tab.
- Importing versions manually
If the component does not import new versions automatically, you can import versions manually.
- Cleaning up component versions
You can configure the server to reduce the number of component versions by archiving them. You can specify artifacts cleanup settings from the System Settings, or cleanup settings for individual components, and environments.
- Restoring archived component versions
You can restore component versions by reloading archive files.
- Deleting versions
If specific component versions meet the criteria for deletion, you can delete them.
- Downloading component version artifacts
Artifacts are generated when an application process of a component version runs successfully.
- Adding links to component version
Component version links help you get information about what a particular version contains from various systems of record such as Anthill Pro, Jira, GitHub, and so on.
- Configuring cleanup settings
On the Cleanup Configuration page, you can edit the cleanup settings of multiple components and environments at once.
Parent topic: Components