Docs / Shipping code

Repositories

Register the Bitbucket repositories your applications are built from.

A repository is where an application’s source lives. SysJ reads it with a token you create; the token is kept in a secret store and never shown in the console.

Register a repository

  1. In Bitbucket, create a repository access token with Repositories: Read, under Repository settings, Security, Access tokens.
  2. In SysJ, open Repositories and add the repository by its clone URL, such as https://bitbucket.org/your-workspace/your-repo.git, with its default branch. Leave credentials out of the URL.
  3. Send the token to your SysJ operator, who stores it at the place shown under the repository’s URL. The console never asks for it.
  4. Choose Check the connection from the repository’s menu.

Connection states

StateMeaning
PendingNothing has tried the token yet, or the URL just changed. Choose Check.
ConnectedSysJ read the repository with its token.
FailedThe last attempt was refused. The reason is shown, for example that Bitbucket found no such repository or the token cannot see it.

Changing a repository’s URL resets it to Pending. When a repository is connected, the deploy dialog offers its branches; otherwise you type the branch name.