# Java

> For AI agents: the complete documentation index is at https://buddy.works/llms.txt

Learn how to compile Java with Maven/Gradle and deploy application.

With Buddy, you can create a pipeline that compiles, tests, and deploys Java applications on a push to Git. The configuration is super simple and takes 10 to 15 minutes.

![Java pipeline example](https://buddy.works/docs/quickstart/java/java-1.png)

## 1. Create a new project

Go to **Projects** and click **Create new project**. Select your Git hosting provider (Buddy, GitHub, Bitbucket, GitLab, or Private Server) and enter your project name.

![Create new project](https://buddy.works/docs/_global/create-new-project.png)

## 2. Add a new pipeline

Navigate to **Pipelines** and click **New pipeline**. In the form, configure the following:

- **Name** - Enter a descriptive name for your pipeline (e.g., "Deploy to production")
- **ID** - Optional identifier for the pipeline
- **CPU** - Select architecture: **x64** or **ARM64**
- **Resources per pipeline run** - Choose resource allocation (default: Workspace default)
- **[Definition Location](https://buddy.works/docs/pipelines/introduction/advanced-settings.md#definition-location)** - Optionally check "Store configuration in a Git repository" to use YAML files

Click **Add pipeline** to create it.

![Add new pipeline](https://buddy.works/docs/_global/add-new-pipeline.png)

## 3. Configure workflow: contexts and triggers

After creating the pipeline, go to the **Workflow** tab to configure:

![Configure Workflow](https://buddy.works/docs/_global/configure-workflow.png)

* **Contexts** - Click `+` to add Git branch/tag context or Environment. See [Contexts](https://buddy.works/docs/pipelines/introduction/contexts.md).

* **Triggers** - Click `+` to add Git events, Schedule, or Webhook. See [Workflow Configuration](https://buddy.works/docs/pipelines/introduction/creating-pipeline/workflow-configuration.md).


## 4. Add actions

Buddy lets you choose from dozens of predefined actions. In this example, we'll add 4 actions that will perform the following tasks:

* Build and test your Java application with Maven
* Upload code toe server together with compiled assets
* Run db migration & restart server
* Send notification to Slack

### 4.1 Build and test your Java application

> **Success**
>
> Build actions in Buddy are run in isolated containers run from official Docker images. When the pipeline is run, Buddy pulls the container, runs build commands, and uploads the results to the pipeline filesystem.

Look up and click **Maven** on the action list to add it to the pipeline: 

![Action list](https://buddy.works/docs/quickstart/java/java-2.png)

> **Info**
>
> Buddy has dedicated actions for **Gradle** and **Maven** compilers. If you use something else, e.g. Ant, you can define a custom Docker image as the runtime template in the environment tab.

The Run tab lets you determine the commands to execute. The default commands are:

```bash
mvn clean install
```

![Maven default build command](https://buddy.works/docs/quickstart/java/java-3.png)

#### 4.1.2 Maven version

You can change the version of Maven and install missing packages & tools in the runtime environment tab:

![Haskell action image](https://buddy.works/docs/quickstart/java/java-4.png)

> **Tip**
>
> If your tests require a database to run, you can [attach it in the Services](https://buddy.works/docs/actions/services-and-databases.md) tab:
>
> ![Services tab](https://buddy.works/docs/_global/add-services-mysql.png)

### 4.2 Deploy application to server

The compiled application needs to be uploaded to the server. Head to the **Deploy** tab and select your upload action (Transfer in our case, where you can choose SFTP Target):

![File transfer actions](https://buddy.works/docs/_global/transfer-actions-sftp.png)

When adding the action you can choose what and where should be uploaded:

![SFTP action configuration](https://buddy.works/docs/_global/sftp-target-tab.png)

> **Info**
>
> [Targets](https://buddy.works/docs/targets/introduction.md) allow to save pre-configured transfer server settings to be used across multiple actions.

### 4.3 Run db migration & restart server

Once the app is deployed, you can run additional commands on your server with the **SSH** action:

![SSH action selection](https://buddy.works/docs/_global/add-ssh-action.png)

Enter the commands to execute together and configure authentication details:

![Command console](https://buddy.works/docs/_global/ssh-migrate-database.png)

### 4.4 Send notification to Slack

You can configure Buddy to send your team a [message](https://buddy.works/docs/actions/notifications.md) after the deployment. In this example we'll use **Slack**:

![Notification actions](https://buddy.works/docs/_global/add-slack-notification.png)

> **Info**
>
> If you add this action in the On Failure tab, Buddy will only send the message if something goes wrong with your build or deployment.
>
> ![On failure notification](https://buddy.works/docs/_global/slack-on-failure.png)

## 5. Summary

**Congratulations!** You have just automated your entire delivery process. Make a push to the selected branch and watch Buddy fetch, build, and deploy your project. With Continuous Delivery applied, you can now focus on what's really important: developing awesome apps! 🔥

> **Success**
>
> Bear in mind that this article is only a brief example of what Buddy can do. You can create additional pipelines for staging and production environments, integrate with your favorite services \(AWS, Google, Azure\), trigger tests on pull requests, build Docker images, and push them to the registry—the possibilities are unlimited.
>
> If you want us to create a delivery pipeline for your project, drop a line to [support@buddy.works](mailto:support@buddy.works) – we'll be happy to help!


---
Original source: https://buddy.works/docs/basics/workflows/java