Configuring the SFTP artifact handler
The SFTP artifact handler can store artifacts on a remote POSIX-compliant (Linux, Unix) SSH server, which helps reduce the load and disk usage on the Bamboo server and improve its performance. This works by allowing Bamboo agents to communicate with the SSH server directly, completely bypassing the Bamboo server during artifact publishing and retrieval.
Artifacts saved to a remote SSH server by the SFTP artifact handler are accessible directly on the SSH server or through the Bamboo interface. In the latter case, the Bamboo server acts as a proxy between the client browser and the SSH server.
Make sure that your SSH server supports the SFTP protocol extension. If you're using OpenSSH, SFTP is enabled by default, and no action is required.
Changing artifact handler configuration details requires Administrator permissions.
To enable and configure the SFTP artifact handler:
- Select Administration > Plans > Artifact handlers
- Enable the SFTP artifact handler for shared and non-shared artifacts by selecting the appropriate checkbox.
Scroll down to the Handler-specific configuration section and configure the SFTP artifact handler.
- Optionally, de-select the handlers you want to stop using.
- Select Save.
- If you want to test the connection to the SSH server, select Test connection.
Bamboo will now attempt to create and immediately remove a file on the SSH server to verify that it's accessible and that file system permissions are set correctly.