Projects are the main container that Sleuth uses to organize your change sources. For example, a project can correlate to a web app you have created, or a staging or development environment for that application.
To create a new project:
Click Create project.
Name your project and give it a description, if desired.
To track deployments, Sleuth must have access to the code you deploy. In order to access all of your commist, issues and pull request information, Sleuth needs to authorize with a full read and write scope of your code repository and most other change sources.
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.
Sleuth uses your code repos as its main sources of change. By analyzing past behavior (i.e., commits, pull requests, issues, feature flags, etc.) and comparing it with your current and future deploys, Sleuth paints a picture of your entire project's health status, giving you instant feedback on the changes you and your team are making to the code base. Sleuth can also look at feature flags and infrastructure environments, and provide you with actionable metrics for those platforms.
To add a source of change, first make sure you have the necessary permissions.
How does Sleuth know when you have deployed? There are three different ways that Sleuth can be notified:
Ping Sleuth with a Git commit SHA or tag to mark your deploy by making a POST request, like so:
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
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.
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.
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:
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 email@example.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, on the Edit Project dialog, you can change the project name or add a description.