{"id":21313987,"url":"https://github.com/octopusdeploy/octopus-bamboo","last_synced_at":"2025-07-12T01:30:58.609Z","repository":{"id":21663870,"uuid":"90926510","full_name":"OctopusDeploy/Octopus-Bamboo","owner":"OctopusDeploy","description":"| Public |  Octopus plugin for Bamboo","archived":false,"fork":false,"pushed_at":"2025-03-16T23:50:48.000Z","size":3301,"stargazers_count":8,"open_issues_count":12,"forks_count":8,"subscribers_count":18,"default_branch":"main","last_synced_at":"2025-04-06T12:02:49.383Z","etag":null,"topics":["bamboo","octopus-deploy","public"],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OctopusDeploy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-05-11T02:05:55.000Z","updated_at":"2024-12-17T07:11:39.000Z","dependencies_parsed_at":"2024-12-17T06:26:02.947Z","dependency_job_id":"6239bc05-1044-4c20-b54c-acda0c07ae9f","html_url":"https://github.com/OctopusDeploy/Octopus-Bamboo","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/OctopusDeploy/Octopus-Bamboo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2FOctopus-Bamboo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2FOctopus-Bamboo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2FOctopus-Bamboo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2FOctopus-Bamboo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OctopusDeploy","download_url":"https://codeload.github.com/OctopusDeploy/Octopus-Bamboo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OctopusDeploy%2FOctopus-Bamboo/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264923080,"owners_count":23683716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bamboo","octopus-deploy","public"],"created_at":"2024-11-21T18:09:39.546Z","updated_at":"2025-07-12T01:30:58.568Z","avatar_url":"https://github.com/OctopusDeploy.png","language":"Java","readme":"# Octopus Deploy Bamboo Plugin\n\n## Documentation\nhttps://octopus.com/docs/api-and-integration/bamboo/bamboo-plugin\n\n## SDK Installation\nThis plugin used the Atlassian SDK. You can find more information about how to install and run the SDK from\nhttps://developer.atlassian.com/display/DOCS/Introduction+to+the+Atlassian+Plugin+SDK\n\n## Updating Bamboo Dependencies\nEdit the `pom.xml` file and set `\u003cbamboo.version\u003e6.2.1\u003c/bamboo.version\u003e` and `\u003cbamboo.data.version\u003e6.2.1\u003c/bamboo.data.version\u003e`\n(the actual versions will be different to these examples) to the latest Bamboo version. This in turn will mean `atlas-run`\nwill load the specified Bamboo version.\n\nYou can find the versions that are available at https://maven.atlassian.com/maven-external/com/atlassian/bamboo/atlassian-bamboo-web/.\n\n## Running Bamboo\nRun the command `atlas-run` to start an instance of Bamboo with the plugin deployed.\n\nThe credentials are `admin` / `admin`.\n\nIf Bamboo fails to start running `atlas-clean` may resolve the issue.\n\nNote there is a bug in AMPS 8.0.0 that means `atlas-run` doesn't work.\nSee https://ecosystem.atlassian.net/browse/AMPS-1479 for details. The workaround\nis to run\n```\nmvn com.atlassian.maven.plugins:amps-dispatcher-maven-plugin:8.0.0:run -gs C:/Applications/Atlassian/atlassian-plugin-sdk-8.0.4/apache-maven-3.5.4/conf/settings.xml\n```\n\n## Debugging Bamboo\n\nRun the command `atlas-debug` to start an instance of Bamboo with the plugin deployed and debugging enabled.\n\nCreate a Remote Debug configuration as below.\n\n![](debug-config.png)\n\nOnce the atlas command has the server to the point where it is fully running, you can start the Remote Debug configuration and IntelliJ will attach to the running process.\n\n## Testing changes on a remote Bamboo build agent\n_Taken directly from Atlassian's [Bamboo remote agent installation guide](https://confluence.atlassian.com/bamboo/bamboo-remote-agent-installation-guide-289276832.html)._\n\n##### 1. Enable remote agent support\n\n- Click the ![cog](cog.png) icon in the Bamboo header and choose **Overview**.\n- In the left-hand panel, under Build Resources, click **Agents**.\n- Click either **Enable Remote Agent Support** or **Disable Remote Agent Support**.\n\n##### 2. Download and install the remote agent\n- Create a directory on the agent machine (e.g. `bamboo-agent-home`) to serve as the Bamboo agent home for the remote agent.\n- Click the ![cog](cog.png) icon in the Bamboo header and choose **Overview**.\n- In the left-hand panel, under Build Resource, click **Agents** in the left panel.\n  - The _'Agents'_ screen displays showing the lists of all local agents and all remote agents that currently exist on your Bamboo system.\n- If not already enabled, click the **Enable remote agent support** link \n- Click **Install Remote Agent**. The _'Installing a remote agent'_ screen will display\n- Click **DOWNLOAD Remote Agent JAR** and save the JAR file to the directory on the agent machine that you created above.\n- Copy the command under _'Running a Remote Agent'_ to the clipboard for use in Step 3 that follows.\n\n##### 3. Launch the remote agent\nOnce installed, run the remote agent by executing the command line obtained above. This command will look something like this:\n```\njava -jar atlassian-bamboo-agent-installer-\u003cversion\u003e.jar http://bamboo-host-server:6990/bamboo/agentServer/\n```\n\n## Building the Plugin\nRun the command `atlas-package` to build the plugin. The compiled plugin will be saved as `target\\bamboo.jar`.\n\n## Deploying a new version of the plugin to the Atlassian Marketplace\n\n### Automated process\n\nWe use [release-please](https://github.com/googleapis/release-please) and [conventional commits](https://www.conventionalcommits.org) to generate release notes for new versions.\n\nThe process once the `release-please` PR is merged is as follows:\n1. Build and package a new plugin JAR file\n2. Push the package to [Octopus](https://deploy.octopus.app/app#/Spaces-62/projects/bamboo-plugin)\n3. Automatically kick off a deployment to the `Production` environment\n   - Upload plugin JAR file using the Atlassian Marketplace REST API\n   - Create a new app version in the Atlassian Marketplace using the Atlassian Marketplace REST API\n   - Confirm that the new app version was created\n      - If the process fails to create the new app version, the deployment will fail\n\n### Manual process\n\nKeep in mind that the Bamboo plugin does not ship with the Octopus CLI tool. Updates to the CLI tool don't\nrequire that the Bamboo plugin be republished.\n\nTo update the marketplace, use the following steps:\n1. Build the new JAR file. \n   - You can do this locally, or get the artifact from the GitHub Actions run for the version you want to publish. \n   - **Note** that if you are building locally you will need to increment the version inside the pom.xml file before building (`\u003cversion\u003e1.0.3\u003c/version\u003e`). This version is used by the store to show the latest artifact to end users.\n2. Browse to https://marketplace.atlassian.com/manage/plugins/com.octopus.bamboo/versions. Use the `atlassian@octopus.com`\n   account - credentials are in the password manager.\n3. Click the `Create version` button.\n4. Follow the wizard to upload the JAR file. The wizard will show you a lot of pages relating to how the add-on is\n   to be displayed, but you can keep the exiting content. The only requirement are some release notes.\n\n### Nightly builds\n\nThe nightly process is nearly identical to our release process (differences highlighted):\n1. Build and package a new **pre-release versioned** plugin JAR file\n2. Push the package to [Octopus](https://deploy.octopus.app/app#/Spaces-62/projects/bamboo-plugin)\n3. Automatically kick off a deployment to the **`Test`** environment\n   - Upload plugin JAR file using the Atlassian Marketplace REST API\n   - Create a new **private** app version in the Atlassian Marketplace using the Atlassian Marketplace REST API\n      - This version will not be visible in the marketplace for people outside the Octopus organization\n   - Confirm that the new app version was created\n      - If the process fails to create the new app version, the deployment will fail\n\n## Automated Bamboo server compatibility version updates\n\nWe have a weekly scheduled [workflow](.github/workflows/bamboo-compatibility-check.yml) that checks if there has been a new version of Bamboo server released since we last updated our Bamboo plugin.\n\nThis process is as follows:\n1. Check if a new version of Bamboo server has been released\n   - If there is no new version, execution is stopped\n2. Open a new issue with details of current and new Bamboo compatible versions\n   - If there is already an open issue, it will update the existing issue with the new version details\n3. Update the compatible Bamboo version in the `\u003cbamboo.version\u003e` and `\u003cbamboo.data.version\u003e` properties inside the `pom.xml` file\n4. Commit and push the changes to a new branch\n5. Open a PR for the changes\n   - The issue from step 2 above will be referenced and will be closed once the PR is merged\n\nOnce the PR has been reviewed and merged, the automated `release-please` process described [above](#automated-process) will take over to push the new version of the plugin to the Atlassian Marketplace.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foctopusdeploy%2Foctopus-bamboo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foctopusdeploy%2Foctopus-bamboo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foctopusdeploy%2Foctopus-bamboo/lists"}