To configure a project you must link your personal or organization's GitHub or Bitbucket accounts to your Sleuth organization.
To create a new project:
Click Create.
Click Create project.
To track deploys we must have access to the code you deploy. In order to access all of your commit, issue and pull request information, we need to authorize with a full read and write scope of your Github or Bitbucket repo.
Select the code repository from the dropdown and specify the branch that you deploy from. Sleuth will initialize the project with your last commit until further deploys are detected.
How does Sleuth know when you have deployed? There are three different ways that Sleuth can be notified:
​Manually.
Ping us with a Git commit sha or tag to mark your deploy by making a POST to Sleuth.
curl -X POST -d api_key=YOUR_API_KEY -d sha=YOUR_SHA https://sleuth.io/api/1/ORG_NAME/PROJECT_NAME/register_deploy
Make sure to replace YOUR_API_KEY
, YOUR_SHA
, ORG_NAME
and PROJECT_NAME
with your actual information. You can find your API Key in Organization Settings > Details > Api key.
You can find YOUR_SHA
with the commands:
git checkout YOUR_BRANCHgit rev-parse HEAD
When this option is selected Sleuth will add a POST-commit hook to your repository on GitHub or Bitbucket.
This will ping Sleuth every time a commit is made. When we detect a commit against your projects branch we'll register a new deploy.
When this option is selected, Sleuth will add a POST-commit hook to your repository on Bitbucket or GitHub.
This will ping Sleuth every time a commit is made. When we detect a tag against your projects branch, Sleuth will register a new deploy.
A tag name can be anything but we suggest something like: production_2015-04-18--16-15
To tag your code and push your changes to your remote repository, use a similar command to:
git tag production_2015-04-18--16-15git push git@github.com:joeuser/myrepo.git production_2015-04-18--16-15
After creating a project, you might want to make changes to its configuration. This can be pointing to a different repo or adding or deleting an integration. This can be done by selecting your project in the sidebar.
In the screenshot below, Documentation is the currently the active project.
With the project selected, click on the gear icon and select Edit Project.
Here you can change the project name or add a description.