Infrastructure

Repositories

Staging area for recipes

conda-forge/staged-recipes is the entry point for new packages to join the conda-forge package collection. You can find a detailed guide to submitting new package recipes in The staging process.

Smithy

Smithy contains maintenance code for conda-forge, which is used by the conda smithy command line tool and the Admin web services. Smithy lives in the repository conda-forge/conda-smithy.

conda-forge/conda-smithy is the right repository to report bugs for

  • the rerendering process

  • the recipe linter

  • CI support utils

conda-smithy also contains the commandline tool that you will use if you rerender manually from the commandline (see Rerendering feedstocks).

Web services

The heroku app providing the conda-forge web services are living in conda-forge/conda-forge-webservices. Please note that the code logic provided by the app is in the Smithy repository.

Bugs or suggestions regarding the service functionality should therefore be opened in at conda-forge/conda-smithy’s bug tracker.

conda-forge pinning

Package-wide dependency pins are defined in conda_build_config.yaml in the conda-forge/conda-forge-pinning-feedstock.

For more information on conda-forge wide package pins, please refer to Globally pinned packages.

Please open PR and/or issues there if you think a pin needs to be advanced. For more information on updating globally pinned packages, please refer to Updating package pins.

Documentation

The documentation lives in conda-forge/conda-forge.github.io and is automatically deployed to our online version.

The documentation is built with Sphinx and the sources files are located in the src directory of the repository.

If you found a typo, unclear explanations or new topics that could be covered, you can suggest changes to the documentation. For more details, please refer to Improving the documentation.

Admin web services

conda-forge is running a webservice on heroku called conda-forge-webservices.

The following services are run by default on a feedstock:

  • It will lint the recipes in the PRs and report back whether recipe is in excellent condition or not.

  • When maintainers are added to a recipe, the maintainer will be added to the team and given push access.

The webservice also listens to issue and PR comments so that you can ask for the following services to be done.

@conda-forge-admin, please rerender

Entering the above phrase in a PR of a feedstock will rerender the feedstock and push the changes to your PR. Make sure to tick the Allow edits from maintainers. button locate at the bottom of the right side bar of the PR. If you say this phrase in an issue comment, the bot will create a new pull request with the requested re-rendering completed.

@conda-forge-admin, please add noarch: python

Entering the above phrase in a PR or issue of a feedstock will add noarch: python to the build and rerender the feedstock for you.

@conda-forge-admin, please update for conda-build 3

This command will attempt to update a recipe to the new conda-build 3 format. It can be sent either in an issue or a PR.

Note that this update command is kind of a hack, and things might go wrong. Make sure to look over the changes, and ask for help if you’re not sure about something.

@conda-forge-admin, please lint

Entering the above phrase in a PR of a feedstock will lint the PR again.

@conda-forge-admin, please update circle

Entering the above phrase in an issue of a feedstock will update the Circle-CI SSH deploy key. This will fix the permission denied (public key) issue in Circle-CI checkout phase; it shouldn’t be needed otherwise.

@conda-forge-admin, please update team

Entering the above phrase in an issue will update the team for the feedstock. This is usually done automatically.

CI build services

Here we describe common issues with the CI Services that conda-forge builds.

Azure Pipelines

Azure is used to build packages for OS X, Linux, Linux (ARMv8) and Linux (IBM Power8+). The build queue on azure is substantially larger than on all the other providers. Azure builds have a maximum duration of 6 hours.

To see all build on azure go to https://dev.azure.com/conda-forge/feedstock-builds/_build.

Restarting builds

Presently azure does not sync Github users. In order to restart a build you can restart it from the Github checks interface. If that doesn’t work, a close/open will kick off a new build.

Using azure for everything

Azure is the default provider for Linux and OS X. To use azure for everything add the following to conda-forge.yml in the root of the feedstock.

provider:
  win: azure

Note

Presently azure has some issues building libraries using cmake on windows. Azure does not have a VS2008 installation so building certain very old packages that require VC9 will fail.

Travis CI (OS X)

Travis CI is used to build packages for OS X. After merging a staged-recipes pull request, it might be necessary to force sync your repositories in Travis CI to see the reload and cancel buttons. To do this please visit https://travis-ci.org/profile and click “Sync accounts”.

Enabling travis

TravisCI should only be needed to build recipes on OS X if there is a strange failure on azure.

Enable a build by adding the following to conda-forge.yml in the root of the feedstock.

provider:
  osx: travis

CircleCI (Linux, OSX)

Circle CI is a container-based CI service that conda-forge uses to build linux packages. It can optionally build OSX packages.

Linux builds are identical to those on azure as both are built inside docker containers.

Using Circle for both Linux and OSX

To use CircleCI for OSX, add the following to conda-forge.yml in the root of the feedstock.

provider:
  osx: circle
  linux: circle

CircleCI for OSX should be used for OSX only when Travis-CI resources (50 minutes of build time per job) is not enough as CircleCI gives more resources (2 hours of build time per job).

Note that you need to rerender the feedstock once this change has been made.

Enabling Circle on your Fork

If for some reason Circle CI is not triggering build from forks, Circle can be manually added for each fork. Circle calls this “Adding a Project” and the official Circle’s documentation is available here. This effectively amount to going to the Add Projects page, finding the fork that you wish to enable, and clicking the “Build Project” button. This is not normally needed.

If CircleCI lacks permissions to checkout the source code, it will produce an error like follows:

Cloning into '.'...
Warning: Permanently added the RSA host key for IP address '192.30.253.113' to the list of known hosts.
Permission denied (publickey).
fatal: Could not read from remote repository.

When this happens for a feedstock, it can be fixed using the webservice, by posting the following comment:

@conda-forge-admin, please update circle

Otherwise (e.g. in a PR to staged-recipes), here are some things you can try:

  • Log in and out of Circle CI.

  • Revoke Circle CI’s access and then enable it again.

  • In the “Checkout SSH keys” section of your Circle CI project settings, press “add user key”.

Appveyor

Appveyor is used to build windows packages. It is the only provider that can build recipes that require Visual Studio 2008.

Skipping CI builds

Todo

  • add information regarding [ci skip] for all CIs.