Jenkins
Learn how to use Jenkins with Filebase.

What is Jenkins?

Jenkins is an open-source automation server platform built on Java that can be used with a wide variety of plugins to automate any server task. It can be downloaded and installed on Windows, Linux, macOS X, or as a Docker or Kubernetes container.
Read below to learn how to configure your Jenkins environment for use with Filebase.
This guide will use a Windows client for configuration, but the steps and parameters will be the same regardless of which installation method you are using.

Prerequisites:

  • Download and install Java. Jenkins only supports Java 1.8 or Java 11.
  • Have Your Filebase Access and Secret Keys. Learn how to view your access keys here.
  • Create a Filebase Bucket. Learn how to create a bucket here.

1. Login to your Jenkins server at http://localhost:8080

If you haven’t configured your Jenkins server prior, finish the installation by installing the recommended plugins and setting up your admin account.

2. Once logged into the Jenkins home page, select ‘Manage Jenkins’ from the left side bar menu.

3. Select ‘Manage Plugins’

4. Select the ‘Available’ tab, search for ‘s3’, then select the ‘Artifact Manager on S3’ plugin.

Select the tick box next to ‘Artifact Manager on S3’ then select ‘Install without restart’ to install the Artifact Manager on S3 plugin.

5. Confirm that the Artifact Manager on S3 plugin has been installed.

6. Go back to the Manage Jenkins dashboard. Select ‘AWS’.

7. Configure the following settings:

  • S3 Bucket Name: Filebase Bucket Name
  • Custom Endpoint: s3.filebase.com
  • Custom Signing Region: us-east-1
  • Check ‘Use Path Style URL’
  • Check ‘Disable Session Token’

8. Scroll down to the AWS Credentials section.

Configure the following settings:
  • Region: US East (N. Virginia)
Next to the Amazon Credentials drop down menu, select ‘Add’.

9. Configure the following settings:

  • Domain: Global
  • Kind: AWS Credentials
  • Scope: Global
  • Description: Filebase
  • Access Key ID: Your Filebase Access Key
  • Secret Access Key: Your Filebase Secret Key

10. Save these credentials.

Then from the drop down menu under AWS Credentials, select your Filebase credentials. Select ‘Save’ to save these settings.

11. Go back to your Jenkins dashboard.

Select ‘New Item’ from the left side bar menu.

12. Enter a new item name, then select ‘Freestyle Project’.

13. Configure your Jenkins project to fit your workflow.

Scroll down to the Post-Build actions.

14. Select ‘Add post-build action, then select ‘Archive the Artifacts’.

15. Enter the name(s) of the artifacts you want to archive.

This example will archive everything. This archive function archives the artifacts to the Filebase configuration you specified earlier.

16. Save this configuration.

Then on the left side bar menu, select ‘Build now’. The build should be successful, indicated by the green check mark under the build history.
If you have any questions, please join our Discord server, or send us an email at [email protected]