Fixing Bamboo files and folder permission for Linux installations

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

プラットフォームについて: Server および Data Center のみ。この記事は、Server および Data Center プラットフォームのアトラシアン製品にのみ適用されます。

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Fisheye および Crucible は除く

要約

There are many reasons why a Bamboo instance will fail to start, a build won't be able to run or an agent won't be able to access an artifact.

Most of the time it is related to permissions on files or folders. This can be caused by numerous reasons, some of the known reasons are:

  • Starting Bamboo with a different user (like root)
  • Editing a config file with a different user
  • Starting your remote agent with a different user
  • Installing or upgrading Bamboo with root user and then trying to start Bamboo with the Bamboo user

These are just a few common examples as there are many other problems related to permission of the files and folders.

診断

You may be able to identify that a file or folder has the wrong permission with the following command:

Go to your /opt folder (or the folder where you chose to install Bamboo)
Run the command ls -la
Do the same for your Bamboo-home folder

The correct output for that is to see your Bamboo user like the following image:

In case you identify any file being owned by the root user or any other user other than the user you're using to start the Bamboo service, that might be the problem. All subfolders and files inside those folders must also be owned by this same user.

That is also true for the remote agent home folder, which must belong to the user you are running your agent with.

ソリューション

Fix the ownership of the folders and files. You may do that by using the following command

Main folders:

chown -R BAMBOO_USERNAME:GROUP_NAME /path-to/bamboo- home
chown -R BAMBOO_USERNAME:GROUP_NAME /path to/bamboo-installation-folder

Agents: 

chown -R agent_username:group_name /path to/remote-agent-folder

The -R parameter will run the command recursively meaning that the ownership for all files and subfolders inside the folder will also be adjusted.



最終更新日: 2022 年 1 月 26 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.