Conan Repository (Beta)

Conan is a dependency and package manager for C and C++. It is designed to help manage the development and Continuous Integration of C and C++ projects. We support both Conan v1 and v2.

🚧

Conan is Beta

Conan is a format currently in Beta. We welcome your feedback for improvements.

⚠️

Note

Conan v1 and v2 packages are not compatible with each other. If you have v1 packages uploaded in our platform these won't be visible when using the Conan v2 CLI and have to be re-uploaded with the proper recipe changes. Please refer to the Conan v2 Migration Guide on how to.

For more information please see:

• Conan: The official Conan website
• Conan Documentation: The official docs for Conan

Contextual Documentation

The examples in this document are generic. Cloudsmith provides contextual setup instructions within each repository, complete with copy n' paste snippets (with your namespace/repo pre-configured).

In the following examples:

Upload a Package

Upload via Conan

The endpoint for the native Conan API is:

https://conan.cloudsmith.io/OWNER/REPOSITORY/

First, you need to set up the Repository as a Conan remote, with your Cloudsmith API-Key and Username for authentication:

conan remote add OWNER-REPOSITORY https://conan.cloudsmith.io/OWNER/REPOSITORY/
conan user -p API-KEY -r OWNER-REPOSITORY USERNAME

conan remote add OWNER-REPOSITORY https://conan.cloudsmith.io/OWNER/REPOSITORY/
conan remote login -p API-KEY OWNER-REPOSITORY USERNAME

You can then upload natively using Conan with the command:

conan upload PACKAGE_NAME/PACKAGE_VERSION --all -r OWNER-REPOSITORY

conan upload PACKAGE_NAME/PACKAGE_VERSION -r OWNER-REPOSITORY

An optional USER/CHANNEL can also be provided when uploading a package; this enables multiple versions of the same package to coexist using the user/channel to create a unique version of the package version:

conan upload PACKAGE_NAME/PACKAGE_VERSION@USER/CHANNEL --all -r OWNER-REPOSITORY

conan upload PACKAGE_NAME/PACKAGE_VERSION@USER/CHANNEL -r OWNER-REPOSITORY

The user/channel will also be used as a tag on the package which will allow for filtering within the UI.

Upload via the Cloudsmith CLI or Website

Note

Uploading using the Cloudsmith CLI or Website is only supported for Conan v1 packages. For v2 packages please use the Conan CLI tooling.

Create a Package

To upload via the Cloudsmith API/CLI, you'll need to generate a package first. The following commands can be used to produce a package and collect the additional files required for upload (otherwise handled by conan upload).

📘

Please see the Conan documentation on creating packages for more information on building your own packages.

You can build a package with Conan by creating a new example project using new, create, and export:

conan new PACKAGE_NAME/PACKAGE_VERSION -t
conan create .
conan install .
conan build .
conan package .
conan export .

To create a package, files need to be extracted from the Conan home directory:

export CLOUDSMITH_REPOSITORY=OWNER/REPOSITORY

use _ when user/channel is treated

path=/home/circleci/.conan/data/example-conan-package/0.0.1/_/_

List files in build directory (using wildcard to skip over autogenerated id):

info_file=$(ls -d $path/package/*/conaninfo.txt)
metadata_file=( "$path/export/conanfile.py" )
manifest_file=( "$path/export/conanmanifest.txt" )
package_directory=( "$path/export" )

Create an archive in the current directory for upload (metadata only):

tar -czf conan_package.tgz --absolute-names "$package_directory"

🚧

External network requests in conanfile.py

When extracting metadata from the conanfile.py, Cloudsmith restricts all network access, meaning that any attempt to reach external services from within your conanfile.py will fail, potentially leading to package synchronization to fail.

We recommend keeping your conanfile.py as simple as possible to ensure your upload does not encounter any issues.

Upload via Cloudsmith CLI

For full details of how to install and setup the Cloudsmith CLI, see Command Line Interface.

The package and additional files can then be uploaded via the Cloudsmith CLI. The following example shows an upload via the CLI.:

cloudsmith push conan "$CLOUDSMITH_REPOSITORY" conan_package.tgz \
    --metadata-file "$metadata_file" \
    --info-file "$info_file"  \
    --manifest-file "$manifest_file"

Upload via Cloudsmith Website

Please see Upload a Package for details of how to upload via the Website UI.

Download / Install a Package

Setup

First, the remote repository must be created and then credentials can be added for a user as follows:

Public Repositories

conan remote add OWNER-REPOSITORY https://conan.cloudsmith.io/OWNER/REPOSITORY/
conan user -p API-KEY -r OWNER-REPOSITORY USERNAME

conan remote add OWNER-REPOSITORY https://conan.cloudsmith.io/OWNER/REPOSITORY/
conan remote login -p API-KEY OWNER-REPOSITORY USERNAME

Private Repositories

📘

Private Cloudsmith repositories require authentication. You can choose between two types of authentication, Entitlement Token Authentication or HTTP Basic Authentication.

The setup method will differ depending on what authentication type you choose to use.

🚧

Entitlement Tokens, User Credentials and API-Keys should be treated as secrets, and you should ensure that you do not commit them in configurations files along with source code or expose them in any logs

conan remote add OWNER-REPOSITORY https://conan.cloudsmith.io/OWNER/REPOSITORY/
conan user -p TOKEN -r OWNER-REPOSITORY OWNER/REPOSITORY

conan remote add OWNER-REPOSITORY https://conan.cloudsmith.io/OWNER/REPOSITORY/
conan user -p PASSWORD -r OWNER-REPOSITORY USERNAME

conan remote add OWNER-REPOSITORY https://conan.cloudsmith.io/OWNER/REPOSITORY/
conan user -p API-KEY -r OWNER-REPOSITORY USERNAME

conan remote add OWNER-REPOSITORY https://conan.cloudsmith.io/OWNER/REPOSITORY/
conan user -p TOKEN -r OWNER-REPOSITORY token

conan remote add OWNER-REPOSITORY https://conan.cloudsmith.io/OWNER/REPOSITORY/
conan remote login -p TOKEN OWNER-REPOSITORY OWNER/REPOSITORY

conan remote add OWNER-REPOSITORY https://conan.cloudsmith.io/OWNER/REPOSITORY/
conan remote login -p PASSWORD OWNER-REPOSITORY USERNAME

conan remote add OWNER-REPOSITORY https://conan.cloudsmith.io/OWNER/REPOSITORY/
conan remote login -p API-KEY OWNER-REPOSITORY USERNAME

conan remote add OWNER-REPOSITORY https://conan.cloudsmith.io/OWNER/REPOSITORY/
conan remote login -p TOKEN OWNER-REPOSITORY token

Install a Package

Once set up, Conan can download the package by running:

conan download PACKAGE_NAME/PACKAGE_VERSION@ -r OWNER-REPOSITORY

Conan Revisions

⚠️

Note

Package revisions uploads are only supported using Conan CLI. Uploading a v1 package with the Cloudsmith CLI or Website doesn't create a revision

Cloudsmith Conan repositores support Package Revisions. By default all Conan v2 uploads use revisions.

Enable revisions in Conan v1

When using the Conan v1 CLI you have to explicitly enable revisions by either:

• Adding revisions_enabled=1 in the [general] section of your conan.conf file (preferred)
• Setting the CONAN_REVISIONS_ENABLED=1 environment variable.

After enabling revisions, the conan upload command will upload revisions instead.

Upstream Proxying / Caching

Not Supported

Key Signing Support

Not Supported by Format

Troubleshooting

Please see the Troubleshooting Conan page for further help and information.