Pushing a binary artifact to a registry

To push a binary artifact, use a POST HTTP request. When sending the request, use authentication with an IAM token. The maximum size of the file to push is 100 MB.

Request example:

curl \
  --request PUT \
  --user "iam:<IAM_token>" \
  --header "X-Checksum-SHA256: <file_hash>" \
  --upload-file <local_path_to_file> \
  https://registry.yandexcloud.net/binaries/<registry_ID>/<artifact_name>/<artifact_version>/<file_name_in_registry>

Where:

• In the --user authentication parameter, specify the iam username and the IAM token value.

• In the X-Checksum-SHA256 header, you can specify the hash of the file you are pushing to check the file’s integrity after it is pushed. This is an optional header.

  You can generate the hash, e.g., using this command:

  openssl dgst -sha256 <file_path> | awk '{print $2}'
  

• In the --upload-file parameter, specify the local path to the file being pushed.

• The request URL contains the registry URL, the artifact name and version, as well as the file name in the registry. Here is an example:

  https://registry.yandexcloud.net/binaries/cn15fqbr806r********/sample-package/3.5.4/agent-installer.sh