├── src ├── .DS_Store ├── test │ ├── resources │ │ └── application.properties │ └── java │ │ └── com │ │ └── jakubduchon │ │ └── webapidemo │ │ └── WebapiDemoApplicationTests.java └── main │ ├── java │ └── com │ │ └── jakubduchon │ │ └── webapidemo │ │ ├── projects │ │ ├── ProjectRepository.java │ │ ├── ProjectNotFoundException.java │ │ ├── ProjectController.java │ │ └── Project.java │ │ ├── employee │ │ ├── EmployeeRepository.java │ │ ├── EmployeeNotFoundException.java │ │ ├── EmployeeNotFoundAdvice.java │ │ ├── EmployeeController.java │ │ └── Employee.java │ │ ├── WebapiDemoApplication.java │ │ ├── DefaultController.java │ │ └── LoadDatabase.java │ └── resources │ └── application.properties ├── docs ├── architecture.png └── DEPLOY_ELASTIC_BEANSTALK.md ├── .elasticbeanstalk └── config.yml ├── .mvn └── wrapper │ ├── maven-wrapper.jar │ ├── maven-wrapper.properties │ └── MavenWrapperDownloader.java ├── .gitignore ├── pom.xml ├── README.md ├── .github └── workflows │ └── deploy_webapi.yaml ├── mvnw.cmd └── mvnw /src/.DS_Store: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/imduchy/cloud-workshop/HEAD/src/.DS_Store -------------------------------------------------------------------------------- /docs/architecture.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/imduchy/cloud-workshop/HEAD/docs/architecture.png -------------------------------------------------------------------------------- /.elasticbeanstalk/config.yml: -------------------------------------------------------------------------------- 1 | # This has to be 2 | deploy: 3 | artifact: cloud-workshop-example.jar 4 | -------------------------------------------------------------------------------- /.mvn/wrapper/maven-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/imduchy/cloud-workshop/HEAD/.mvn/wrapper/maven-wrapper.jar -------------------------------------------------------------------------------- /src/test/resources/application.properties: -------------------------------------------------------------------------------- 1 | spring.datasource.driver-class-name=org.h2.Driver 2 | spring.datasource.url=jdbc:h2:mem:db;DB_CLOSE_DELAY=-1 3 | spring.datasource.username=sa 4 | spring.datasource.password=sa -------------------------------------------------------------------------------- /.mvn/wrapper/maven-wrapper.properties: -------------------------------------------------------------------------------- 1 | distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.8.1/apache-maven-3.8.1-bin.zip 2 | wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar 3 | -------------------------------------------------------------------------------- /src/main/java/com/jakubduchon/webapidemo/projects/ProjectRepository.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo.projects; 2 | 3 | import org.springframework.data.jpa.repository.JpaRepository; 4 | 5 | public interface ProjectRepository extends JpaRepository { 6 | } 7 | -------------------------------------------------------------------------------- /src/main/java/com/jakubduchon/webapidemo/employee/EmployeeRepository.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo.employee; 2 | 3 | import org.springframework.data.jpa.repository.JpaRepository; 4 | 5 | public interface EmployeeRepository extends JpaRepository { 6 | } 7 | -------------------------------------------------------------------------------- /src/main/java/com/jakubduchon/webapidemo/employee/EmployeeNotFoundException.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo.employee; 2 | 3 | class EmployeeNotFoundException extends RuntimeException { 4 | EmployeeNotFoundException(Long id) { 5 | super("Could not find employee with id " + id); 6 | } 7 | } 8 | -------------------------------------------------------------------------------- /src/main/java/com/jakubduchon/webapidemo/projects/ProjectNotFoundException.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo.projects; 2 | 3 | class ProjectNotFoundException extends RuntimeException { 4 | ProjectNotFoundException(Long id) { 5 | super("Could not find project with id " + id); 6 | } 7 | } 8 | -------------------------------------------------------------------------------- /src/test/java/com/jakubduchon/webapidemo/WebapiDemoApplicationTests.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo; 2 | 3 | import org.junit.jupiter.api.Test; 4 | import org.springframework.boot.test.context.SpringBootTest; 5 | 6 | @SpringBootTest 7 | class WebapiDemoApplicationTests { 8 | 9 | @Test 10 | void contextLoads() { 11 | } 12 | 13 | } 14 | -------------------------------------------------------------------------------- /src/main/java/com/jakubduchon/webapidemo/WebapiDemoApplication.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo; 2 | 3 | import org.springframework.boot.SpringApplication; 4 | import org.springframework.boot.autoconfigure.SpringBootApplication; 5 | 6 | @SpringBootApplication 7 | public class WebapiDemoApplication { 8 | 9 | public static void main(String[] args) { 10 | SpringApplication.run(WebapiDemoApplication.class, args); 11 | } 12 | 13 | } 14 | -------------------------------------------------------------------------------- /src/main/java/com/jakubduchon/webapidemo/DefaultController.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo; 2 | 3 | import org.springframework.web.bind.annotation.GetMapping; 4 | import org.springframework.web.bind.annotation.RestController; 5 | 6 | @RestController 7 | public class DefaultController { 8 | 9 | @GetMapping("/") 10 | String health() { 11 | return "Hello students! :) The application was deployed using GitHub Actions! <3"; 12 | } 13 | } 14 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | HELP.md 2 | target/ 3 | !.mvn/wrapper/maven-wrapper.jar 4 | !**/src/main/**/target/ 5 | !**/src/test/**/target/ 6 | 7 | ### STS ### 8 | .apt_generated 9 | .classpath 10 | .factorypath 11 | .project 12 | .settings 13 | .springBeans 14 | .sts4-cache 15 | 16 | ### IntelliJ IDEA ### 17 | .idea 18 | *.iws 19 | *.iml 20 | *.ipr 21 | 22 | ### NetBeans ### 23 | /nbproject/private/ 24 | /nbbuild/ 25 | /dist/ 26 | /nbdist/ 27 | /.nb-gradle/ 28 | build/ 29 | !**/src/main/**/build/ 30 | !**/src/test/**/build/ 31 | 32 | ### VS Code ### 33 | .vscode/ 34 | .DS_Store 35 | -------------------------------------------------------------------------------- /src/main/resources/application.properties: -------------------------------------------------------------------------------- 1 | spring.datasource.url=jdbc:postgresql://localhost:5432/postgres 2 | spring.datasource.username=postgres 3 | spring.datasource.password=password 4 | spring.jpa.hibernate.ddl-auto=create-drop 5 | spring.jpa.show-sql=true 6 | spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect 7 | spring.jpa.properties.hibernate.format_sql=true 8 | 9 | #spring.datasource.driver-class-name=org.h2.Driver 10 | #spring.datasource.url=jdbc:h2:mem:db;DB_CLOSE_DELAY=-1 11 | #spring.datasource.username=sa 12 | #spring.datasource.password=sa 13 | -------------------------------------------------------------------------------- /src/main/java/com/jakubduchon/webapidemo/employee/EmployeeNotFoundAdvice.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo.employee; 2 | 3 | import org.springframework.http.HttpStatus; 4 | import org.springframework.web.bind.annotation.ControllerAdvice; 5 | import org.springframework.web.bind.annotation.ExceptionHandler; 6 | import org.springframework.web.bind.annotation.ResponseBody; 7 | import org.springframework.web.bind.annotation.ResponseStatus; 8 | 9 | @ControllerAdvice 10 | public class EmployeeNotFoundAdvice { 11 | @ResponseBody 12 | @ExceptionHandler(EmployeeNotFoundException.class) 13 | @ResponseStatus(HttpStatus.NOT_FOUND) 14 | String emploeeNotFoundHandler(EmployeeNotFoundException ex) { 15 | return ex.getMessage(); 16 | } 17 | } 18 | -------------------------------------------------------------------------------- /src/main/java/com/jakubduchon/webapidemo/LoadDatabase.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo; 2 | 3 | import com.jakubduchon.webapidemo.employee.Employee; 4 | import com.jakubduchon.webapidemo.employee.EmployeeRepository; 5 | import com.jakubduchon.webapidemo.projects.Project; 6 | import com.jakubduchon.webapidemo.projects.ProjectRepository; 7 | import org.slf4j.Logger; 8 | import org.slf4j.LoggerFactory; 9 | import org.springframework.boot.CommandLineRunner; 10 | import org.springframework.context.annotation.Bean; 11 | import org.springframework.context.annotation.Configuration; 12 | 13 | @Configuration 14 | public class LoadDatabase { 15 | private static final Logger log = LoggerFactory.getLogger(LoadDatabase.class); 16 | 17 | @Bean 18 | CommandLineRunner initDatabase(EmployeeRepository employeeRepo, ProjectRepository projectrRepo) { 19 | return args -> { 20 | Employee bob = new Employee("Bob Buffalo", "Software Engineer"); 21 | Employee alice = new Employee("Alice Anaconda", "Product Owner"); 22 | Project cryptoPuppies = new Project("Crypto puppies", "Unicorn NFT project"); 23 | log.info("Preloading " + employeeRepo.save(bob)); 24 | log.info("Preloading " + employeeRepo.save(alice)); 25 | log.info("Preloading " + projectrRepo.save(cryptoPuppies)); 26 | }; 27 | } 28 | } 29 | -------------------------------------------------------------------------------- /src/main/java/com/jakubduchon/webapidemo/employee/EmployeeController.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo.employee; 2 | 3 | import org.springframework.web.bind.annotation.*; 4 | 5 | import java.util.List; 6 | 7 | @RestController 8 | public class EmployeeController { 9 | 10 | private final EmployeeRepository repository; 11 | 12 | EmployeeController(EmployeeRepository repository) { 13 | this.repository = repository; 14 | } 15 | 16 | @GetMapping("/employees") 17 | List all() { 18 | return repository.findAll(); 19 | } 20 | 21 | @PostMapping("/employees") 22 | Employee newEmployee(@RequestBody Employee newEmployee) { 23 | return repository.save(newEmployee); 24 | } 25 | 26 | @GetMapping("/employees/{id}") 27 | Employee one(@PathVariable Long id) { 28 | return repository.findById(id).orElseThrow( 29 | () -> new EmployeeNotFoundException(id) 30 | ); 31 | } 32 | 33 | @PutMapping("/employees/{id}") 34 | Employee updateEmployee(@RequestBody Employee newEmployee, @PathVariable Long id) { 35 | return repository.findById(id) 36 | .map(employee -> { 37 | employee.setName(newEmployee.getName()); 38 | employee.setRole(newEmployee.getRole()); 39 | employee.setProjects(newEmployee.getProjects()); 40 | return repository.save(employee); 41 | }) 42 | .orElseGet(() -> { 43 | newEmployee.setId(id); 44 | return repository.save(newEmployee); 45 | }); 46 | } 47 | 48 | @DeleteMapping("employees/{id}") 49 | void deleteEmployee(@PathVariable Long id) { 50 | repository.deleteById(id); 51 | } 52 | } 53 | -------------------------------------------------------------------------------- /pom.xml: -------------------------------------------------------------------------------- 1 | 2 | 4 | 4.0.0 5 | 6 | org.springframework.boot 7 | spring-boot-starter-parent 8 | 2.4.4 9 | 10 | 11 | com.jakubduchon 12 | webapi-demo 13 | 0.0.1-SNAPSHOT 14 | webapi-demo 15 | Demo project for the Cloud Workshop 16 | 17 | 11 18 | 19 | 20 | 21 | org.springframework.boot 22 | spring-boot-starter-data-jpa 23 | 24 | 25 | org.springframework.boot 26 | spring-boot-starter-web 27 | 28 | 29 | 30 | org.postgresql 31 | postgresql 32 | runtime 33 | 34 | 35 | org.springframework.boot 36 | spring-boot-starter-test 37 | test 38 | 39 | 40 | com.h2database 41 | h2 42 | 43 | 44 | 45 | 46 | cloud-workshop-example 47 | 48 | 49 | org.springframework.boot 50 | spring-boot-maven-plugin 51 | 52 | 53 | 54 | 55 | 56 | -------------------------------------------------------------------------------- /src/main/java/com/jakubduchon/webapidemo/employee/Employee.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo.employee; 2 | 3 | import com.fasterxml.jackson.annotation.JsonIgnoreProperties; 4 | import com.jakubduchon.webapidemo.projects.Project; 5 | import org.hibernate.annotations.GenericGenerator; 6 | 7 | import javax.persistence.*; 8 | import java.util.HashSet; 9 | import java.util.Set; 10 | 11 | @Entity(name = "Employee") 12 | @Table(name = "employee") 13 | public class Employee { 14 | @Id 15 | @GeneratedValue(generator = "sequence-generator") 16 | @GenericGenerator( 17 | name = "sequence-generator", 18 | strategy = "org.hibernate.id.enhanced.SequenceStyleGenerator", 19 | parameters = { 20 | @org.hibernate.annotations.Parameter(name = "sequence_name", value = "employee_sequence"), 21 | @org.hibernate.annotations.Parameter(name = "initial_value", value = "1"), 22 | @org.hibernate.annotations.Parameter(name = "increment_size", value = "1") 23 | } 24 | ) 25 | @Column(updatable = false) 26 | private Long id; 27 | @Column(nullable = false) 28 | private String name; 29 | @Column(nullable = false) 30 | private String role; 31 | @ManyToMany(mappedBy = "enrolledEmployees") 32 | @JsonIgnoreProperties("enrolledEmployees") 33 | private Set projects; 34 | 35 | Employee() { 36 | } 37 | 38 | public Employee(String name, String role) { 39 | this.name = name; 40 | this.role = role; 41 | this.projects = new HashSet<>(); 42 | } 43 | 44 | public Long getId() { 45 | return id; 46 | } 47 | 48 | public void setId(Long id) { 49 | this.id = id; 50 | } 51 | 52 | public String getName() { 53 | return name; 54 | } 55 | 56 | public void setName(String name) { 57 | this.name = name; 58 | } 59 | 60 | public String getRole() { 61 | return role; 62 | } 63 | 64 | public void setRole(String role) { 65 | this.role = role; 66 | } 67 | 68 | public Set getProjects() { 69 | return projects; 70 | } 71 | 72 | public void setProjects(Set projects) { 73 | this.projects = projects; 74 | } 75 | } 76 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Cloud Workshop 2 | 3 | This repository contains a bootstrapped Java Spring Boot application for the Cloud Workshop. The application was generated with [Spring initializr](https://start.spring.io/#!type=maven-project&language=java&platformVersion=2.4.4.RELEASE&packaging=jar&jvmVersion=11&groupId=com.jakubduchon&artifactId=webapi-demo&name=webapi-demo&description=Demo%20project%20for%20the%20Cloud%20Workshop&packageName=com.jakubduchon.webapi-demo&dependencies=web,data-jpa,postgresql) and contains Spring Web, Spring Data JPA and PostgreSQL driver dependencies. To use a different database, simply replace the PostgreSQL Driver with the one of your choice (e.g., MS SQL Server Driver). 4 | 5 | The workshop is hosted for the 4th-semester Software Engineering students at VIA University Horsens. Throughout the workshop, students will learn how to deploy applications to AWS and utilize the cloud for hosting their Semester projects online. 6 | 7 | ## Architecture 8 | 9 | To host the Spring Boot application we will use AWS Elastic Beanstalk, and AWS RDS to host the database. Both of the services are fully managed, require minimal setup and are part of the AWS Free Tier. The Spring Boot application will connect to the RDS database and will be exposed to the internet via a Web API. 10 | 11 | ![architecture diagram](https://github.com/Duchynko/cloud-workshop/blob/main/docs/architecture.png?raw=true "Architecture diagram") 12 | 13 | ## Prerequisites 14 | 15 | - Git installed 16 | - Java installed and set up 17 | - PostgreSQL installed 18 | - AWS Account (a credit card required) 19 | 20 | ## How to set up the project locally 21 | 22 | 1. Clone the project locally (e.g., using SSH with `git clone git@github.com:iamduchy/cloud-workshop.git`) 23 | 2. Replace the `username`, `password` and `url` fields in the `src/main/resources/application.properties` and provide your own database credentials 24 | 3. Make sure your database is up and running 25 | 4. Start the application 26 | 27 | ## How to deploy application to AWS Elastic Beanstalk 28 | 29 | - [Deployment steps](docs/DEPLOY_ELASTIC_BEANSTALK.md) 30 | 31 | ## Useful links 32 | 33 | - [Introduction to AWS Elastic Beanstalk](https://www.youtube.com/watch?v=uiM1xzOX8Qg) 34 | - [Deploying a Spring Boot Application on AWS Using AWS Elastic Beanstalk](https://aws.amazon.com/blogs/devops/deploying-a-spring-boot-application-on-aws-using-aws-elastic-beanstalk/) 35 | -------------------------------------------------------------------------------- /src/main/java/com/jakubduchon/webapidemo/projects/ProjectController.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo.projects; 2 | 3 | import com.jakubduchon.webapidemo.employee.Employee; 4 | import com.jakubduchon.webapidemo.employee.EmployeeRepository; 5 | import org.springframework.web.bind.annotation.*; 6 | 7 | import java.util.List; 8 | 9 | @RestController 10 | public class ProjectController { 11 | 12 | private final ProjectRepository repository; 13 | private final EmployeeRepository employeeRepository; 14 | 15 | public ProjectController(ProjectRepository repository, EmployeeRepository employeeRepository) { 16 | this.repository = repository; 17 | this.employeeRepository = employeeRepository; 18 | } 19 | 20 | @GetMapping("/projects") 21 | List all() { 22 | return repository.findAll(); 23 | } 24 | 25 | @GetMapping("/projects/{id}") 26 | Project one(@PathVariable Long id) { 27 | return repository.findById(id).orElseThrow( 28 | () -> new ProjectNotFoundException(id) 29 | ); 30 | } 31 | 32 | @PutMapping("/projects/{pid}/employee/{eid}") 33 | Project enrollEmployee(@PathVariable Long pid, @PathVariable Long eid) { 34 | Project project = repository.findById(pid).get(); 35 | Employee employee = employeeRepository.findById(eid).get(); 36 | project.enrollEmployee(employee); 37 | return repository.save(project); 38 | } 39 | 40 | @PutMapping("/projects/{id}") 41 | Project updateProject(@RequestBody Project newProject, @PathVariable Long id) { 42 | return repository.findById(id) 43 | .map(project -> { 44 | project.setName(newProject.getName()); 45 | project.setDescription(newProject.getDescription()); 46 | project.setEnrolledEmployees(newProject.getEnrolledEmployees()); 47 | return project; 48 | }) 49 | .orElseGet(() -> { 50 | newProject.setId(id); 51 | return repository.save(newProject); 52 | }); 53 | } 54 | 55 | @PostMapping("/projects") 56 | Project newProject(@RequestBody Project newProject) { 57 | return repository.save(newProject); 58 | } 59 | 60 | @DeleteMapping("/projects/{id}") 61 | void deleteProject(@PathVariable Long id) { 62 | repository.deleteById(id); 63 | } 64 | } 65 | -------------------------------------------------------------------------------- /src/main/java/com/jakubduchon/webapidemo/projects/Project.java: -------------------------------------------------------------------------------- 1 | package com.jakubduchon.webapidemo.projects; 2 | 3 | import com.fasterxml.jackson.annotation.*; 4 | import com.jakubduchon.webapidemo.employee.Employee; 5 | import org.hibernate.annotations.GenericGenerator; 6 | 7 | import javax.persistence.*; 8 | import java.util.HashSet; 9 | import java.util.Set; 10 | 11 | @Entity(name = "Project") 12 | @Table(name = "project") 13 | public class Project { 14 | @Id 15 | @GeneratedValue(generator = "sequence-generator") 16 | @GenericGenerator( 17 | name = "sequence-generator", 18 | strategy = "org.hibernate.id.enhanced.SequenceStyleGenerator", 19 | parameters = { 20 | @org.hibernate.annotations.Parameter(name = "sequence_name", value = "project_sequence"), 21 | @org.hibernate.annotations.Parameter(name = "initial_value", value = "1"), 22 | @org.hibernate.annotations.Parameter(name = "increment_size", value = "1") 23 | } 24 | ) 25 | @Column(updatable = false) 26 | private Long id; 27 | @Column(nullable = false) 28 | private String name; 29 | @Column(nullable = false, columnDefinition = "TEXT") 30 | private String description; 31 | @ManyToMany 32 | @JoinTable( 33 | name = "employees_projects", 34 | joinColumns = @JoinColumn(name = "project_id"), 35 | inverseJoinColumns = @JoinColumn(name = "employee_id") 36 | ) 37 | @JsonIgnoreProperties("projects") 38 | private Set enrolledEmployees; 39 | 40 | public Project(String name, String description) { 41 | this.name = name; 42 | this.description = description; 43 | this.enrolledEmployees = new HashSet<>(); 44 | } 45 | 46 | public Project() { 47 | } 48 | 49 | public void enrollEmployee(Employee employee) { 50 | this.enrolledEmployees.add(employee); 51 | } 52 | 53 | public Long getId() { 54 | return id; 55 | } 56 | 57 | public void setId(Long id) { 58 | this.id = id; 59 | } 60 | 61 | public String getName() { 62 | return name; 63 | } 64 | 65 | public void setName(String name) { 66 | this.name = name; 67 | } 68 | 69 | public String getDescription() { 70 | return description; 71 | } 72 | 73 | public void setDescription(String description) { 74 | this.description = description; 75 | } 76 | 77 | public Set getEnrolledEmployees() { 78 | return enrolledEmployees; 79 | } 80 | 81 | public void setEnrolledEmployees(Set enrolledEmployees) { 82 | this.enrolledEmployees = enrolledEmployees; 83 | } 84 | } 85 | -------------------------------------------------------------------------------- /.github/workflows/deploy_webapi.yaml: -------------------------------------------------------------------------------- 1 | # Name of the workflow (action) which will be displaye on GitHub 2 | name: Deploy webapi to EB 3 | 4 | # Specifies when should the workflow run. Currently it's set-up to every push 5 | # to the branch called 'main'. 6 | on: 7 | push: 8 | branches: 9 | # If you use 'master' branch instead, don't forget to change this to 'master' 10 | - main 11 | paths: 12 | # Only trigger the workflow if changes were made to files inside the 'src' 13 | # folder. This will make sure that application is not re-deployed if changes 14 | # are made to other files (e.g., README, docs/ or anything outside 'src') 15 | - src/** 16 | 17 | # Global environment variables 18 | env: 19 | APPLICATION_NAME: CloudWorkshop2022 20 | ENVIRONMENT_NAME: Cloudworkshop2022-env 21 | AWS_REGION: eu-west-1 22 | 23 | # Each workflow consists of one or many jobs 24 | jobs: 25 | # A build job (this can be named called whatever you like) 26 | build: 27 | runs-on: ubuntu-latest 28 | 29 | # Each job consists of one or many steps 30 | steps: 31 | - name: Checkout the repo 32 | uses: actions/checkout@v2 33 | 34 | # Documentation for this action - https://github.com/actions/setup-java 35 | - name: Set up JDK 11 36 | uses: actions/setup-java@v2 37 | with: 38 | java-version: "11" 39 | distribution: "adopt" # one of the supported Java distributions 40 | 41 | - name: Build and package 42 | # The following command will execute mvn (Maven) validate, compile, test, 43 | # package and verify commands. A good explaination of the Maven's project 44 | # lifecycle from StackOverflow - https://stackoverflow.com/a/55645546/8475178 45 | run: mvn --batch-mode --update-snapshots verify 46 | 47 | # GitHub Actions don't persist files between jobs, so we will upload the 48 | # packaged jar file as an artifact, and then download it in the next job. 49 | - name: Upload the build artifact 50 | uses: actions/upload-artifact@v2 51 | with: 52 | name: jar-package 53 | path: target/*.jar 54 | # We can remove the build artifact from GitHub after one day. There is a 55 | # 1GB storage limit for artifacts, and we don't really need them after 56 | # the deployment. 57 | retention-days: 1 58 | 59 | # Deployment job 60 | deploy: 61 | runs-on: ubuntu-latest 62 | # Only start executing after the build job has completed successfully 63 | needs: build 64 | 65 | steps: 66 | - name: Checkout the repo 67 | uses: actions/checkout@v2 68 | 69 | # Download the packaged jar file 70 | - name: Download the build artifact 71 | uses: actions/download-artifact@v2 72 | id: download 73 | with: 74 | name: jar-package 75 | 76 | # Generate a deployment package with all files necessary for AWS Elastic Beanstalk 77 | # engine. This includes the packaged jar file and the .elasticbeanstalk folder 78 | # which contains config.yml file. 79 | - name: Generate deployment package 80 | run: zip -r deploy.zip *.jar .elasticbeanstalk 81 | 82 | - name: Deploy to Elastic Beanstalk 83 | uses: einaregilsson/beanstalk-deploy@v16 84 | with: 85 | # To make this work, you need to create an IAM User (ideally with least 86 | # privilege access) and store the generated Access key ID and Secret 87 | # access key to your GitHub repository Secrets. 88 | # > DO NOT HARDCODE THE VALUES DIRECTLY INTO THE CODE !!! 89 | aws_access_key: ${{ secrets.AWS_ACCESS_KEY_ID }} 90 | aws_secret_key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} 91 | # Make sure to set these variables based on your application/region 92 | application_name: ${{ env.APPLICATION_NAME }} 93 | environment_name: ${{ env.ENVIRONMENT_NAME }} 94 | version_label: v1-${{ github.sha }} 95 | region: ${{ env.AWS_REGION }} 96 | # Deployment package we created in the previous step 97 | deployment_package: deploy.zip 98 | -------------------------------------------------------------------------------- /docs/DEPLOY_ELASTIC_BEANSTALK.md: -------------------------------------------------------------------------------- 1 | # Deploying Java application to AWS Elastic Beanstalk 2 | 3 | This document explains how to deploy the demo application to AWS Elastic Beanstalk using AWS Console. 4 | 5 | ### Step 0 6 | Start by opening the AWS Console and selecting the **Ireland** region in the top right corner. 7 | 8 | ### Step 1 9 | 10 | Navigate to **Elastic Beanstalk** (use the search bar in the navigation bar). Click on the **Create Application** button to start configuring the web app. 11 | 12 | ### Step 2 13 | 14 | Choose a name for your application, e.g., "workshop-demo". You can leave Application Tags empty. In the **Platform** dropdown menu choose **Java**, for the **Platform branch** choose **Java (Corretto) 11**, and for the **Platform version** choose the **Recommended** option. 15 | 16 | ### Step 3 17 | 18 | For the **Application code** choose **Upload your code**. In the following section fill in the **Version label** with a unique name for the version of your application code, e.g., "1.0.0". For the **Source code origin** choose **Local file** and upload the generated `.war` file. This file should be located inside of your project in the `/target` folder. 19 | 20 | ### Step 4 21 | 22 | Click on **Create application** and wait until the application is created. This can take a couple of minutes. 23 | 24 | ### Step 5 25 | 26 | Make sure that your application is deployed as a 'Single instance' instead of 'Load Balanced'. If it's not deployed as 'Single instance', it will start generating costs (which we want to avoid). The setting can be checked and updated by clicking on **Configuration**, and **Edit** in the **Capacity** row. The **Environment type** should be set as 'Single instance'. If it's not, update it and save the changes by clicking on the **Apply** button at the bottom of the page. 27 | 28 | ### Step 6 29 | 30 | When the application is ready click on **Configuration**, and **Edit** in the **Database** row. Here you can configure a managed RDS Database for your application. 31 | Choose one of the engines (for the workshop we will use **postgres**), fill in the **Username** and **Password** fields and leave all other fields with their 32 | default values. Do not set your Username to _admin_ as it is a reserved user and database creation would fail. 33 | 34 | For **Database deletion policy** select the **Delete** option. 35 | 36 | Make sure that the **Instance class** is set to **db.t2.micro** or **db.t3.micro**. When everything is configured click on **Apply**. Database creation will take a couple of minutes again. 37 | 38 | ### Step 7 39 | 40 | When Elastic Beanstalk finishes with resource creations, in your AWS Console navigate to RDS service (In the navigation menu use the search bar and open the RDS in a new tab). On the left navigation menu click on **Databases** (under Dashboard) and you should see one instance of the database we just created. Click on the DB Identifier and copy the endpoint (e.g., bbpovxui5t2wjv.cwfniba4nd10.us-east-1.rds.amazonaws.com) — we will need it in the following step. 41 | 42 | ### Step 8 43 | 44 | Now we need to tell our application how to connect to the database. In the Elastic Beanstalk menu, click on **-env** and **Configuration**. In the Configuration tab click on the **Edit** button in the **Software** row. On the bottom of the page add the following environment variables (properties). Don't forget to use your values instead of values inside of `< >`. 45 | 46 | ``` 47 | SPRING_DATASOURCE_URL=jdbc:postgresql:///postgres 48 | SPRING_DATASOURCE_USERNAME= 49 | SPRING_DATASOURCE_PASSWORD= 50 | SPRING_JPA_HIBERNATE_DDL_AUTO=update 51 | SPRING_JPA_DATABASE_PLATFORM=org.hibernate.dialect.PostgreSQLDialect 52 | SPRING_DATASOURCE_DRIVER_CLASS_NAME=org.postgresql.Driver 53 | SERVER_PORT=5000 54 | ``` 55 | 56 | The final result should look something like this 57 | 58 | ``` 59 | SPRING_DATASOURCE_URL=jdbc:postgresql://bbpovxui5t2wjv.cwfniba4nd10.us-east-1.rds.amazonaws.com/postgres 60 | SPRING_DATASOURCE_USERNAME=workshop 61 | SPRING_DATASOURCE_PASSWORD=mypassword 62 | SPRING_JPA_HIBERNATE_DDL_AUTO=update 63 | SPRING_JPA_DATABASE_PLATFORM=org.hibernate.dialect.PostgreSQLDialect 64 | SPRING_DATASOURCE_DRIVER_CLASS_NAME=org.postgresql.Driver 65 | SERVER_PORT=5000 66 | ``` 67 | 68 | Apply your changes by clicking on the **Apply** button. 69 | 70 | ### Step 9 71 | 72 | Your application should be ready to go! Test it out by clicking on the **Go to environment** option in the left navigation menu, or by directly openning the application's endpoint. 73 | -------------------------------------------------------------------------------- /.mvn/wrapper/MavenWrapperDownloader.java: -------------------------------------------------------------------------------- 1 | /* 2 | * Copyright 2007-present the original author or authors. 3 | * 4 | * Licensed under the Apache License, Version 2.0 (the "License"); 5 | * you may not use this file except in compliance with the License. 6 | * You may obtain a copy of the License at 7 | * 8 | * https://www.apache.org/licenses/LICENSE-2.0 9 | * 10 | * Unless required by applicable law or agreed to in writing, software 11 | * distributed under the License is distributed on an "AS IS" BASIS, 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 | * See the License for the specific language governing permissions and 14 | * limitations under the License. 15 | */ 16 | import java.net.*; 17 | import java.io.*; 18 | import java.nio.channels.*; 19 | import java.util.Properties; 20 | 21 | public class MavenWrapperDownloader { 22 | 23 | private static final String WRAPPER_VERSION = "0.5.6"; 24 | /** 25 | * Default URL to download the maven-wrapper.jar from, if no 'downloadUrl' is provided. 26 | */ 27 | private static final String DEFAULT_DOWNLOAD_URL = "https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/" 28 | + WRAPPER_VERSION + "/maven-wrapper-" + WRAPPER_VERSION + ".jar"; 29 | 30 | /** 31 | * Path to the maven-wrapper.properties file, which might contain a downloadUrl property to 32 | * use instead of the default one. 33 | */ 34 | private static final String MAVEN_WRAPPER_PROPERTIES_PATH = 35 | ".mvn/wrapper/maven-wrapper.properties"; 36 | 37 | /** 38 | * Path where the maven-wrapper.jar will be saved to. 39 | */ 40 | private static final String MAVEN_WRAPPER_JAR_PATH = 41 | ".mvn/wrapper/maven-wrapper.jar"; 42 | 43 | /** 44 | * Name of the property which should be used to override the default download url for the wrapper. 45 | */ 46 | private static final String PROPERTY_NAME_WRAPPER_URL = "wrapperUrl"; 47 | 48 | public static void main(String args[]) { 49 | System.out.println("- Downloader started"); 50 | File baseDirectory = new File(args[0]); 51 | System.out.println("- Using base directory: " + baseDirectory.getAbsolutePath()); 52 | 53 | // If the maven-wrapper.properties exists, read it and check if it contains a custom 54 | // wrapperUrl parameter. 55 | File mavenWrapperPropertyFile = new File(baseDirectory, MAVEN_WRAPPER_PROPERTIES_PATH); 56 | String url = DEFAULT_DOWNLOAD_URL; 57 | if(mavenWrapperPropertyFile.exists()) { 58 | FileInputStream mavenWrapperPropertyFileInputStream = null; 59 | try { 60 | mavenWrapperPropertyFileInputStream = new FileInputStream(mavenWrapperPropertyFile); 61 | Properties mavenWrapperProperties = new Properties(); 62 | mavenWrapperProperties.load(mavenWrapperPropertyFileInputStream); 63 | url = mavenWrapperProperties.getProperty(PROPERTY_NAME_WRAPPER_URL, url); 64 | } catch (IOException e) { 65 | System.out.println("- ERROR loading '" + MAVEN_WRAPPER_PROPERTIES_PATH + "'"); 66 | } finally { 67 | try { 68 | if(mavenWrapperPropertyFileInputStream != null) { 69 | mavenWrapperPropertyFileInputStream.close(); 70 | } 71 | } catch (IOException e) { 72 | // Ignore ... 73 | } 74 | } 75 | } 76 | System.out.println("- Downloading from: " + url); 77 | 78 | File outputFile = new File(baseDirectory.getAbsolutePath(), MAVEN_WRAPPER_JAR_PATH); 79 | if(!outputFile.getParentFile().exists()) { 80 | if(!outputFile.getParentFile().mkdirs()) { 81 | System.out.println( 82 | "- ERROR creating output directory '" + outputFile.getParentFile().getAbsolutePath() + "'"); 83 | } 84 | } 85 | System.out.println("- Downloading to: " + outputFile.getAbsolutePath()); 86 | try { 87 | downloadFileFromURL(url, outputFile); 88 | System.out.println("Done"); 89 | System.exit(0); 90 | } catch (Throwable e) { 91 | System.out.println("- Error downloading"); 92 | e.printStackTrace(); 93 | System.exit(1); 94 | } 95 | } 96 | 97 | private static void downloadFileFromURL(String urlString, File destination) throws Exception { 98 | if (System.getenv("MVNW_USERNAME") != null && System.getenv("MVNW_PASSWORD") != null) { 99 | String username = System.getenv("MVNW_USERNAME"); 100 | char[] password = System.getenv("MVNW_PASSWORD").toCharArray(); 101 | Authenticator.setDefault(new Authenticator() { 102 | @Override 103 | protected PasswordAuthentication getPasswordAuthentication() { 104 | return new PasswordAuthentication(username, password); 105 | } 106 | }); 107 | } 108 | URL website = new URL(urlString); 109 | ReadableByteChannel rbc; 110 | rbc = Channels.newChannel(website.openStream()); 111 | FileOutputStream fos = new FileOutputStream(destination); 112 | fos.getChannel().transferFrom(rbc, 0, Long.MAX_VALUE); 113 | fos.close(); 114 | rbc.close(); 115 | } 116 | 117 | } 118 | -------------------------------------------------------------------------------- /mvnw.cmd: -------------------------------------------------------------------------------- 1 | @REM ---------------------------------------------------------------------------- 2 | @REM Licensed to the Apache Software Foundation (ASF) under one 3 | @REM or more contributor license agreements. See the NOTICE file 4 | @REM distributed with this work for additional information 5 | @REM regarding copyright ownership. The ASF licenses this file 6 | @REM to you under the Apache License, Version 2.0 (the 7 | @REM "License"); you may not use this file except in compliance 8 | @REM with the License. You may obtain a copy of the License at 9 | @REM 10 | @REM https://www.apache.org/licenses/LICENSE-2.0 11 | @REM 12 | @REM Unless required by applicable law or agreed to in writing, 13 | @REM software distributed under the License is distributed on an 14 | @REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 15 | @REM KIND, either express or implied. See the License for the 16 | @REM specific language governing permissions and limitations 17 | @REM under the License. 18 | @REM ---------------------------------------------------------------------------- 19 | 20 | @REM ---------------------------------------------------------------------------- 21 | @REM Maven Start Up Batch script 22 | @REM 23 | @REM Required ENV vars: 24 | @REM JAVA_HOME - location of a JDK home dir 25 | @REM 26 | @REM Optional ENV vars 27 | @REM M2_HOME - location of maven2's installed home dir 28 | @REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands 29 | @REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a keystroke before ending 30 | @REM MAVEN_OPTS - parameters passed to the Java VM when running Maven 31 | @REM e.g. to debug Maven itself, use 32 | @REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 33 | @REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files 34 | @REM ---------------------------------------------------------------------------- 35 | 36 | @REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on' 37 | @echo off 38 | @REM set title of command window 39 | title %0 40 | @REM enable echoing by setting MAVEN_BATCH_ECHO to 'on' 41 | @if "%MAVEN_BATCH_ECHO%" == "on" echo %MAVEN_BATCH_ECHO% 42 | 43 | @REM set %HOME% to equivalent of $HOME 44 | if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%") 45 | 46 | @REM Execute a user defined script before this one 47 | if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre 48 | @REM check for pre script, once with legacy .bat ending and once with .cmd ending 49 | if exist "%HOME%\mavenrc_pre.bat" call "%HOME%\mavenrc_pre.bat" 50 | if exist "%HOME%\mavenrc_pre.cmd" call "%HOME%\mavenrc_pre.cmd" 51 | :skipRcPre 52 | 53 | @setlocal 54 | 55 | set ERROR_CODE=0 56 | 57 | @REM To isolate internal variables from possible post scripts, we use another setlocal 58 | @setlocal 59 | 60 | @REM ==== START VALIDATION ==== 61 | if not "%JAVA_HOME%" == "" goto OkJHome 62 | 63 | echo. 64 | echo Error: JAVA_HOME not found in your environment. >&2 65 | echo Please set the JAVA_HOME variable in your environment to match the >&2 66 | echo location of your Java installation. >&2 67 | echo. 68 | goto error 69 | 70 | :OkJHome 71 | if exist "%JAVA_HOME%\bin\java.exe" goto init 72 | 73 | echo. 74 | echo Error: JAVA_HOME is set to an invalid directory. >&2 75 | echo JAVA_HOME = "%JAVA_HOME%" >&2 76 | echo Please set the JAVA_HOME variable in your environment to match the >&2 77 | echo location of your Java installation. >&2 78 | echo. 79 | goto error 80 | 81 | @REM ==== END VALIDATION ==== 82 | 83 | :init 84 | 85 | @REM Find the project base dir, i.e. the directory that contains the folder ".mvn". 86 | @REM Fallback to current working directory if not found. 87 | 88 | set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR% 89 | IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir 90 | 91 | set EXEC_DIR=%CD% 92 | set WDIR=%EXEC_DIR% 93 | :findBaseDir 94 | IF EXIST "%WDIR%"\.mvn goto baseDirFound 95 | cd .. 96 | IF "%WDIR%"=="%CD%" goto baseDirNotFound 97 | set WDIR=%CD% 98 | goto findBaseDir 99 | 100 | :baseDirFound 101 | set MAVEN_PROJECTBASEDIR=%WDIR% 102 | cd "%EXEC_DIR%" 103 | goto endDetectBaseDir 104 | 105 | :baseDirNotFound 106 | set MAVEN_PROJECTBASEDIR=%EXEC_DIR% 107 | cd "%EXEC_DIR%" 108 | 109 | :endDetectBaseDir 110 | 111 | IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig 112 | 113 | @setlocal EnableExtensions EnableDelayedExpansion 114 | for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a 115 | @endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS% 116 | 117 | :endReadAdditionalConfig 118 | 119 | SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe" 120 | set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar" 121 | set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain 122 | 123 | set DOWNLOAD_URL="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar" 124 | 125 | FOR /F "tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO ( 126 | IF "%%A"=="wrapperUrl" SET DOWNLOAD_URL=%%B 127 | ) 128 | 129 | @REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central 130 | @REM This allows using the maven wrapper in projects that prohibit checking in binary data. 131 | if exist %WRAPPER_JAR% ( 132 | if "%MVNW_VERBOSE%" == "true" ( 133 | echo Found %WRAPPER_JAR% 134 | ) 135 | ) else ( 136 | if not "%MVNW_REPOURL%" == "" ( 137 | SET DOWNLOAD_URL="%MVNW_REPOURL%/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar" 138 | ) 139 | if "%MVNW_VERBOSE%" == "true" ( 140 | echo Couldn't find %WRAPPER_JAR%, downloading it ... 141 | echo Downloading from: %DOWNLOAD_URL% 142 | ) 143 | 144 | powershell -Command "&{"^ 145 | "$webclient = new-object System.Net.WebClient;"^ 146 | "if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^ 147 | "$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^ 148 | "}"^ 149 | "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%DOWNLOAD_URL%', '%WRAPPER_JAR%')"^ 150 | "}" 151 | if "%MVNW_VERBOSE%" == "true" ( 152 | echo Finished downloading %WRAPPER_JAR% 153 | ) 154 | ) 155 | @REM End of extension 156 | 157 | @REM Provide a "standardized" way to retrieve the CLI args that will 158 | @REM work with both Windows and non-Windows executions. 159 | set MAVEN_CMD_LINE_ARGS=%* 160 | 161 | %MAVEN_JAVA_EXE% %JVM_CONFIG_MAVEN_PROPS% %MAVEN_OPTS% %MAVEN_DEBUG_OPTS% -classpath %WRAPPER_JAR% "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %* 162 | if ERRORLEVEL 1 goto error 163 | goto end 164 | 165 | :error 166 | set ERROR_CODE=1 167 | 168 | :end 169 | @endlocal & set ERROR_CODE=%ERROR_CODE% 170 | 171 | if not "%MAVEN_SKIP_RC%" == "" goto skipRcPost 172 | @REM check for post script, once with legacy .bat ending and once with .cmd ending 173 | if exist "%HOME%\mavenrc_post.bat" call "%HOME%\mavenrc_post.bat" 174 | if exist "%HOME%\mavenrc_post.cmd" call "%HOME%\mavenrc_post.cmd" 175 | :skipRcPost 176 | 177 | @REM pause the script if MAVEN_BATCH_PAUSE is set to 'on' 178 | if "%MAVEN_BATCH_PAUSE%" == "on" pause 179 | 180 | if "%MAVEN_TERMINATE_CMD%" == "on" exit %ERROR_CODE% 181 | 182 | exit /B %ERROR_CODE% 183 | -------------------------------------------------------------------------------- /mvnw: -------------------------------------------------------------------------------- 1 | #!/bin/sh 2 | # ---------------------------------------------------------------------------- 3 | # Licensed to the Apache Software Foundation (ASF) under one 4 | # or more contributor license agreements. See the NOTICE file 5 | # distributed with this work for additional information 6 | # regarding copyright ownership. The ASF licenses this file 7 | # to you under the Apache License, Version 2.0 (the 8 | # "License"); you may not use this file except in compliance 9 | # with the License. You may obtain a copy of the License at 10 | # 11 | # https://www.apache.org/licenses/LICENSE-2.0 12 | # 13 | # Unless required by applicable law or agreed to in writing, 14 | # software distributed under the License is distributed on an 15 | # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16 | # KIND, either express or implied. See the License for the 17 | # specific language governing permissions and limitations 18 | # under the License. 19 | # ---------------------------------------------------------------------------- 20 | 21 | # ---------------------------------------------------------------------------- 22 | # Maven Start Up Batch script 23 | # 24 | # Required ENV vars: 25 | # ------------------ 26 | # JAVA_HOME - location of a JDK home dir 27 | # 28 | # Optional ENV vars 29 | # ----------------- 30 | # M2_HOME - location of maven2's installed home dir 31 | # MAVEN_OPTS - parameters passed to the Java VM when running Maven 32 | # e.g. to debug Maven itself, use 33 | # set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000 34 | # MAVEN_SKIP_RC - flag to disable loading of mavenrc files 35 | # ---------------------------------------------------------------------------- 36 | 37 | if [ -z "$MAVEN_SKIP_RC" ] ; then 38 | 39 | if [ -f /etc/mavenrc ] ; then 40 | . /etc/mavenrc 41 | fi 42 | 43 | if [ -f "$HOME/.mavenrc" ] ; then 44 | . "$HOME/.mavenrc" 45 | fi 46 | 47 | fi 48 | 49 | # OS specific support. $var _must_ be set to either true or false. 50 | cygwin=false; 51 | darwin=false; 52 | mingw=false 53 | case "`uname`" in 54 | CYGWIN*) cygwin=true ;; 55 | MINGW*) mingw=true;; 56 | Darwin*) darwin=true 57 | # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home 58 | # See https://developer.apple.com/library/mac/qa/qa1170/_index.html 59 | if [ -z "$JAVA_HOME" ]; then 60 | if [ -x "/usr/libexec/java_home" ]; then 61 | export JAVA_HOME="`/usr/libexec/java_home`" 62 | else 63 | export JAVA_HOME="/Library/Java/Home" 64 | fi 65 | fi 66 | ;; 67 | esac 68 | 69 | if [ -z "$JAVA_HOME" ] ; then 70 | if [ -r /etc/gentoo-release ] ; then 71 | JAVA_HOME=`java-config --jre-home` 72 | fi 73 | fi 74 | 75 | if [ -z "$M2_HOME" ] ; then 76 | ## resolve links - $0 may be a link to maven's home 77 | PRG="$0" 78 | 79 | # need this for relative symlinks 80 | while [ -h "$PRG" ] ; do 81 | ls=`ls -ld "$PRG"` 82 | link=`expr "$ls" : '.*-> \(.*\)$'` 83 | if expr "$link" : '/.*' > /dev/null; then 84 | PRG="$link" 85 | else 86 | PRG="`dirname "$PRG"`/$link" 87 | fi 88 | done 89 | 90 | saveddir=`pwd` 91 | 92 | M2_HOME=`dirname "$PRG"`/.. 93 | 94 | # make it fully qualified 95 | M2_HOME=`cd "$M2_HOME" && pwd` 96 | 97 | cd "$saveddir" 98 | # echo Using m2 at $M2_HOME 99 | fi 100 | 101 | # For Cygwin, ensure paths are in UNIX format before anything is touched 102 | if $cygwin ; then 103 | [ -n "$M2_HOME" ] && 104 | M2_HOME=`cygpath --unix "$M2_HOME"` 105 | [ -n "$JAVA_HOME" ] && 106 | JAVA_HOME=`cygpath --unix "$JAVA_HOME"` 107 | [ -n "$CLASSPATH" ] && 108 | CLASSPATH=`cygpath --path --unix "$CLASSPATH"` 109 | fi 110 | 111 | # For Mingw, ensure paths are in UNIX format before anything is touched 112 | if $mingw ; then 113 | [ -n "$M2_HOME" ] && 114 | M2_HOME="`(cd "$M2_HOME"; pwd)`" 115 | [ -n "$JAVA_HOME" ] && 116 | JAVA_HOME="`(cd "$JAVA_HOME"; pwd)`" 117 | fi 118 | 119 | if [ -z "$JAVA_HOME" ]; then 120 | javaExecutable="`which javac`" 121 | if [ -n "$javaExecutable" ] && ! [ "`expr \"$javaExecutable\" : '\([^ ]*\)'`" = "no" ]; then 122 | # readlink(1) is not available as standard on Solaris 10. 123 | readLink=`which readlink` 124 | if [ ! `expr "$readLink" : '\([^ ]*\)'` = "no" ]; then 125 | if $darwin ; then 126 | javaHome="`dirname \"$javaExecutable\"`" 127 | javaExecutable="`cd \"$javaHome\" && pwd -P`/javac" 128 | else 129 | javaExecutable="`readlink -f \"$javaExecutable\"`" 130 | fi 131 | javaHome="`dirname \"$javaExecutable\"`" 132 | javaHome=`expr "$javaHome" : '\(.*\)/bin'` 133 | JAVA_HOME="$javaHome" 134 | export JAVA_HOME 135 | fi 136 | fi 137 | fi 138 | 139 | if [ -z "$JAVACMD" ] ; then 140 | if [ -n "$JAVA_HOME" ] ; then 141 | if [ -x "$JAVA_HOME/jre/sh/java" ] ; then 142 | # IBM's JDK on AIX uses strange locations for the executables 143 | JAVACMD="$JAVA_HOME/jre/sh/java" 144 | else 145 | JAVACMD="$JAVA_HOME/bin/java" 146 | fi 147 | else 148 | JAVACMD="`which java`" 149 | fi 150 | fi 151 | 152 | if [ ! -x "$JAVACMD" ] ; then 153 | echo "Error: JAVA_HOME is not defined correctly." >&2 154 | echo " We cannot execute $JAVACMD" >&2 155 | exit 1 156 | fi 157 | 158 | if [ -z "$JAVA_HOME" ] ; then 159 | echo "Warning: JAVA_HOME environment variable is not set." 160 | fi 161 | 162 | CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher 163 | 164 | # traverses directory structure from process work directory to filesystem root 165 | # first directory with .mvn subdirectory is considered project base directory 166 | find_maven_basedir() { 167 | 168 | if [ -z "$1" ] 169 | then 170 | echo "Path not specified to find_maven_basedir" 171 | return 1 172 | fi 173 | 174 | basedir="$1" 175 | wdir="$1" 176 | while [ "$wdir" != '/' ] ; do 177 | if [ -d "$wdir"/.mvn ] ; then 178 | basedir=$wdir 179 | break 180 | fi 181 | # workaround for JBEAP-8937 (on Solaris 10/Sparc) 182 | if [ -d "${wdir}" ]; then 183 | wdir=`cd "$wdir/.."; pwd` 184 | fi 185 | # end of workaround 186 | done 187 | echo "${basedir}" 188 | } 189 | 190 | # concatenates all lines of a file 191 | concat_lines() { 192 | if [ -f "$1" ]; then 193 | echo "$(tr -s '\n' ' ' < "$1")" 194 | fi 195 | } 196 | 197 | BASE_DIR=`find_maven_basedir "$(pwd)"` 198 | if [ -z "$BASE_DIR" ]; then 199 | exit 1; 200 | fi 201 | 202 | ########################################################################################## 203 | # Extension to allow automatically downloading the maven-wrapper.jar from Maven-central 204 | # This allows using the maven wrapper in projects that prohibit checking in binary data. 205 | ########################################################################################## 206 | if [ -r "$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" ]; then 207 | if [ "$MVNW_VERBOSE" = true ]; then 208 | echo "Found .mvn/wrapper/maven-wrapper.jar" 209 | fi 210 | else 211 | if [ "$MVNW_VERBOSE" = true ]; then 212 | echo "Couldn't find .mvn/wrapper/maven-wrapper.jar, downloading it ..." 213 | fi 214 | if [ -n "$MVNW_REPOURL" ]; then 215 | jarUrl="$MVNW_REPOURL/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar" 216 | else 217 | jarUrl="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar" 218 | fi 219 | while IFS="=" read key value; do 220 | case "$key" in (wrapperUrl) jarUrl="$value"; break ;; 221 | esac 222 | done < "$BASE_DIR/.mvn/wrapper/maven-wrapper.properties" 223 | if [ "$MVNW_VERBOSE" = true ]; then 224 | echo "Downloading from: $jarUrl" 225 | fi 226 | wrapperJarPath="$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" 227 | if $cygwin; then 228 | wrapperJarPath=`cygpath --path --windows "$wrapperJarPath"` 229 | fi 230 | 231 | if command -v wget > /dev/null; then 232 | if [ "$MVNW_VERBOSE" = true ]; then 233 | echo "Found wget ... using wget" 234 | fi 235 | if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then 236 | wget "$jarUrl" -O "$wrapperJarPath" 237 | else 238 | wget --http-user=$MVNW_USERNAME --http-password=$MVNW_PASSWORD "$jarUrl" -O "$wrapperJarPath" 239 | fi 240 | elif command -v curl > /dev/null; then 241 | if [ "$MVNW_VERBOSE" = true ]; then 242 | echo "Found curl ... using curl" 243 | fi 244 | if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then 245 | curl -o "$wrapperJarPath" "$jarUrl" -f 246 | else 247 | curl --user $MVNW_USERNAME:$MVNW_PASSWORD -o "$wrapperJarPath" "$jarUrl" -f 248 | fi 249 | 250 | else 251 | if [ "$MVNW_VERBOSE" = true ]; then 252 | echo "Falling back to using Java to download" 253 | fi 254 | javaClass="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.java" 255 | # For Cygwin, switch paths to Windows format before running javac 256 | if $cygwin; then 257 | javaClass=`cygpath --path --windows "$javaClass"` 258 | fi 259 | if [ -e "$javaClass" ]; then 260 | if [ ! -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then 261 | if [ "$MVNW_VERBOSE" = true ]; then 262 | echo " - Compiling MavenWrapperDownloader.java ..." 263 | fi 264 | # Compiling the Java class 265 | ("$JAVA_HOME/bin/javac" "$javaClass") 266 | fi 267 | if [ -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then 268 | # Running the downloader 269 | if [ "$MVNW_VERBOSE" = true ]; then 270 | echo " - Running MavenWrapperDownloader.java ..." 271 | fi 272 | ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$MAVEN_PROJECTBASEDIR") 273 | fi 274 | fi 275 | fi 276 | fi 277 | ########################################################################################## 278 | # End of extension 279 | ########################################################################################## 280 | 281 | export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"} 282 | if [ "$MVNW_VERBOSE" = true ]; then 283 | echo $MAVEN_PROJECTBASEDIR 284 | fi 285 | MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS" 286 | 287 | # For Cygwin, switch paths to Windows format before running java 288 | if $cygwin; then 289 | [ -n "$M2_HOME" ] && 290 | M2_HOME=`cygpath --path --windows "$M2_HOME"` 291 | [ -n "$JAVA_HOME" ] && 292 | JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"` 293 | [ -n "$CLASSPATH" ] && 294 | CLASSPATH=`cygpath --path --windows "$CLASSPATH"` 295 | [ -n "$MAVEN_PROJECTBASEDIR" ] && 296 | MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"` 297 | fi 298 | 299 | # Provide a "standardized" way to retrieve the CLI args that will 300 | # work with both Windows and non-Windows executions. 301 | MAVEN_CMD_LINE_ARGS="$MAVEN_CONFIG $@" 302 | export MAVEN_CMD_LINE_ARGS 303 | 304 | WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain 305 | 306 | exec "$JAVACMD" \ 307 | $MAVEN_OPTS \ 308 | -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \ 309 | "-Dmaven.home=${M2_HOME}" "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \ 310 | ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@" 311 | --------------------------------------------------------------------------------