Projects and Builds
This document describes how CircleCI automates builds of your project.
After a software repository on GitHub or Bitbucket is authorized and added as a project to circleci.com, every code change triggers a build and automated tests in a clean container or VM configured for your requirements.
A CircleCI project shares the name of the associated code repository and is visible on the Projects page of the CircleCI app. Projects are added by using the Add Project button.
On the “Add Projects” page, you can either Set Up any project that you are the owner of on your VCS, or, Follow any project in your organization to gain access to its pipelines and to subscribe to email notifications for the project’s status.
Add Projects Page
The Project Administrator is the user who adds a GitHub or Bitbucket repository to CircleCI as a Project. A User is an individual user within an org. A CircleCI user is anyone who can log in to the CircleCI platform with a username and password. Users must be added to a GitHub or Bitbucket org to view or follow associated CircleCI projects. Users may not view project data that is stored in environment variables.
If you do not see your project and it is not currently building on CircleCI, check your Organization in the top left corner of the CircleCI application. For example, if the top left shows your user
my-user, only GitHub projects belonging to
my-user will be available under
Add Projects. If you want to build the GitHub project
your-org/project, you must select
your-org on the application Switch Organization menu.
Your build appears on the Pipelines page of the CircleCI app when a new commit is pushed to your repository.
You can view workflows or single jobs by clicking in on the workflow or job in each pipeline.
When viewing a single job in a pipeline, you can use the breadcrumbs at the top of the page to navigate back to a job’s respective workflow or pipeline.