Configure an agent with Bitbucket access

Configuring your Moderne Agent instance with Bitbucket is a prerequisite for both viewing recipe results within the Moderne application and committing changes from a recipe.
This guide will walk you through configuring a new Application Link within your Bitbucket Server or Bitbucket Data Center instance.
Prerequisites
Administrator access to your BitBucket on-premise instance.
Step 1 - Generate a public and private key for Bitbucket
1
openssl genrsa -out bitbucket_privatekey.pem 1024
2
openssl req -newkey rsa:1024 -x509 -key bitbucket_privatekey.pem -out bitbucket_publickey.cer -days 365
3
openssl pkcs8 -topk8 -nocrypt -in bitbucket_privatekey.pem -out bitbucket_privatekey.pcks8
4
openssl x509 -pubkey -noout -in bitbucket_publickey.cer  > bitbucket_publickey.pem
Copied!
Step 2 - Create an Application Link in Bitbucket
1.Go to the Administration page of Bitbucket
2.Select Application Links from the System section
3.Click on "Create link"
4.Ensure that the Application Type is set to Atlassian product (this looks weird, but this is the documented path for external applications to integrate)
5.Enter the the URL for your Moderne instances as the Application URL 
​
6.Click Continue
7.Define a new Incoming Application with the following settings:
Field
Value
Application Name
Moderne
Application Type
Generic Application
Service Provider Name
moderne
Consumer key
OauthKey
Shared secret
Enter in your own secret
Request token URL
https://your-domain.moderne.io
Access token URL
https://your-domain.moderne.io
Authorize URL
https://your-domain.moderne.io
Create incoming link
✅
8.Click Continue
9.Complete the Incoming Link configuration
Field
Value
Consumer Key
OauthKey
Consumer Name
Moderne
Public Key
Paste the public key (bitbucket_publickey.pem) from step 1
10.Click Continue to complete the Application Link creation
Step 3 - Configure the Moderne Agent with a Bitbucket private key
To complete the set-up of Bitbucket with the agent we will need to define the private key, bitbucket_privatekey.pcks8, we generated in Step 1 as a run-time parameter for the agent.
1.Open up bitbucket_privatekey.pcks8 in a text editor.
2.Remove the first and last line (header and footer) of the private key.
1.First and last lines would be: -----BEGIN PRIVATE KEY----- and -----END PRIVATE KEY-----
3.Remove all newline and return characters and copy the contents of the file as a single-line string.
4.​Depending on how you run your Agent, you will define the run-time variables moderne.agent.bitbucket[0].private-key with the single-line private key.
Using Bash or other shells?
Quickly get a single-line instance of your private key with the key header/footer removed
cat bitbucket_privatekey.pcks8 | sed '1d;$d' | tr -d '\n'
Argument configuration
OCI Container
Executable JAR
The following arguments must be provided in addition to the arguments provided in 
. You can configure multiple bitbuckets by including multiple entries with different indices. The private key of each index must match up with the host for that index.
moderne_agent_bitbucket_{index}_private-key - Private key configured in previous step
moderne_agent_bitbucket_{index}_host - fully-qualified hostname of running bitbucket instance. example: bitbucket.org
Example using Docker (note that host and private-key are fake):
1
docker run \
2
...
3
-e moderne_agent_bitbucket_0_private-key=ABCDE \
4
-e moderne_agent_bitbucket_0_host=bitbucket.myorg.com \
5
-e moderne_agent_bitbucket_1_private-key=FGHIJ \
6
-e moderne_agent_bitbucket_1_host=bitbucket2.myorg.com \
7
...
Copied!
The following arguments must be provided in addition to the arguments provided in 
. You can configure multiple bitbuckets by including multiple entries with different indices. The private key of each index must match up with the host for that index.
moderne.agent.bitbucket[{index}].private-key - Private key configured in previous step
moderne.agent.bitbucket[{index}].host - fully-qualified hostname of running bucketbucket instance. example: bitbucket.org
Note: system properties can be used in place of arguments. As an example, use -Dmoderne.agent.token={token_value} as an argument instead of --moderne.agent.token={token_value} as an argument.
Example (note that host and private-key are fake):
1
java -jar moderne-agent-{version}.jar \
2
...
3
--moderne.agent.bitbucket[0].private-key=ABCDE \
4
--moderne.agent.bitbucket[0].host=bitbucket.myorg.com \
5
--moderne.agent.bitbucket[1].private-key=FGHIJ \
6
--moderne.agent.bitbucket[1].host=bitbucket2.myorg.com \
7
...
Copied!

How-to Guides - Previous

On-premise agent

Configure an agent with GitHub

Last modified 11d ago

Export as PDF

Copy link

Contents

Step 1 - Generate a public and private key for Bitbucket

Step 2 - Create an Application Link in Bitbucket

Step 3 - Configure the Moderne Agent with a Bitbucket private key

Argument configuration