Artifact CLI Reference#
Note: Using Artifacts during the beta period is free. Once the artifacts system is in the general availability, additional charges will apply based on the usage.
Every project on Semaphore has access to three levels of the artifact store: project, workflow and job. Based on this level, you can retrieve a specific artifact in the job environment and through the web interface. You can read more about suggested use cases here.
artifact command line interface (CLI), is a tool that helps you manage
deliverables created during the CI/CD process of your project on Semaphore.
Currently it is available in Linux and Docker environments on Semaphore.
The general interface of the
artifact utility is:
artifact [COMMAND] [STORE LEVEL] [PATH] [flags]
[COMMAND]- action to be performed for an artifact (
[STORE LEVEL]- level on which specific artifact is available within the artifact store (
[PATH]- points to the artifact (e.g. file or directory)
[flags]- optional command line flags (e.g.
To upload an artifact from Semaphore job it is necessary to specify
the artifact store level and point to a file or directory
artifact push command:
artifact push project my-artifact-v3.tar
-d) - Used to adjust artifact name within the artifact store. Later, on you can use this name with
artifact pullto download the artifact to a Semaphore job. Example:
artifact push project my-artifact.tar --destination releases/my-artifact-v3.tar
-e) - Used to set the artifact expiration time (Nd, Nw, Nm, Ny). For example, you'd probably want to delete uploaded debugging log in a week or so (
artifact push job debugging.log --expire-in 1w).
-f) - By default, every
artifact pushcommand doesn't upload an artifact if it is already available in the store. You can use this option to overwrite existing file.
artifact pull to download an artifact to Semaphore job environment.
It is necessary to specify artifact store level of the target artifact
and point to a file or directory within the store.
artifact pull project my-artifact-v3.tar
-d) - This flag can be used to specify a path to which artifact is downloaded in the Semaphore job environment. Example:
artifact pull project releases/my-artifact-v3.tar --destination my-artifact.tar
-f) - Use this option to overwrite a file or directory within Semaphore job environment.
To remove an artifact from the specific artifact store it is necessary to specify
the store level and point to a file or directory with the
artifact yank command.
artifact yank project my-artifact-v3.tar