Skip to content

Latest commit

 

History

History
137 lines (78 loc) · 8.48 KB

devcs.accs.ci.md

File metadata and controls

137 lines (78 loc) · 8.48 KB

ORACLE Cloud-Native DevOps workshop

Deploy SpringBoot demo application to Application Container Cloud Services using Developer Cloud Services

About this tutorial

Oracle Application Container Cloud Service includes Oracle Java SE Cloud Service and Oracle Node Cloud Service. It provides a lightweight infrastructure so that you can run Java SE 7, Java SE 8, and Node.js applications in the Oracle Cloud.

Oracle Developer Cloud Service is a cloud-based software development Platform as a Service (PaaS) and a hosted environment for your application development infrastructure. It provides an open-source standards-based solution to manage the application development life cycle effectively through integration with Hudson, Git, Maven, issues, and wikis. Using Oracle Developer Cloud Service, you can commit your application source code to the Git repository on the Oracle Cloud, track assigned issues and defects online, share information using wiki pages, peer review the source code, and monitor project builds. After successful testing, you can deploy the project to Oracle Java Cloud Service - SaaS Extension, publicly available Oracle Java Cloud Service instances, Oracle Application Container Cloud Service instances, or to an on-premise production environment.

The key features of Oracle Developer Cloud Service include:

Project creation, configuration, and user management

  • Version control and source code management with Git
  • Storage of application dependencies and libraries with Maven
  • Continuous build integration with Hudson
  • Wiki for document collaboration
  • Issue tracking system to track tasks, defects, and features
  • Repository branch merge after code review
  • Deployment to Oracle Java Cloud Service - SaaS Extension, Oracle Java Cloud Service, and Oracle Application Container Cloud Service

Oracle Developer Cloud Service is available as a web interface accessible from a web browser and from Integrated Development Environments (IDEs) such as Oracle Enterprise Pack for Eclipse (OEPE), Oracle JDeveloper, and NetBeans IDE.

This tutorial shows how to deploy Spring Boot sample application to Application Container Cloud Services using Oracle Developer Cloud Services.

The Spring Boot sample application is a web application serving simple JSP pages.

This tutorial demonstrates how to:

  • configure build job for sample application
  • configure Application Container Cloud Service deployment in Developer Cloud Service
  • build and deploy sample application using Developer Cloud Service

Prerequisites

  • Oracle Public Cloud Service account including Developer Cloud Service

Open Oracle Developer Cloud Service Project

Sign in to https://cloud.oracle.com/sign-in. First select your datacenter then provide the identity domain and credentials. (USE DEVCS DOMAIN CREDENTIALS). After a successful login you will see your Dashboard. Find the Developer services tile and click the hamburger icon. In the dropdown menu click Open Service Console.

Select your Oracle Developer Cloud Service Project which was created using inital Git repository and contains Spring Boot sample application's sources.

Configure build job for Spring Boot sample application

Once the project provisioning is ready let's create the build job to compile and package the sample Spring Boot application to the desired format for Application Container Cloud Services.

Select Build item on the left side menu and click the New Job button.

alt text

Enter a name for the new job. Select the Create a free-style job option and save. On the Main configuration page of the newly created job make sure JDK 8 is the selected JDK.

alt text

Change to the Source Control tab and select Git. In the git's properties section select the only one available Git repository which is provided in the list. Leave the advanced settings default.

alt text

Click Triggers tab to configure SCM polling. Select Based on SCM polling schedule. This ensures if any files in the source code repository has changed then the build will be fired.

alt text

Change to Build Steps tab and add Maven 3 build step. Enter clean install as Goals and springboot-sample/pom.xml to POM File field. (In case if Build Steps tab just shows Loading... for a long time, save the Build configuration then re-open and continue.)

alt text

Finally change to Post Build tab and check in the Archive the artifacts option. Enter springboot-sample/target/*.zip into Files To Archive field.

alt text

Click on Save to update the new job configurations. To check the build job click on Build Now on the job's detail page. Once the job is done check the archived artifacts. It should be the following: springbootdemo-0.0.1.zip

alt text

Please note the build job contains an extra build step which packs the default artifact springbootdemo-0.0.1.war and manifest.json (ACCS descriptor from the springboot-sample/src/acc.resources folder) into a zip archive. This archive is the desired format to deploy a Java application to ACCS.

Configure Application Container Cloud service deployment

Now create deployment configuration which enable direct deployment to Application Container Cloud services after a successful build job. Change to Deploy page in DevCS and create New Configuration

alt text

Set the following properties. alt text

  • Configuration Name: any name to identify deployment configuration
  • Application Name: instance name in ACCS. This will determine the application's URL.
  • Deployment Target: click New and select Application Container Cloud... and define connection properties such as Data center, Identity Domain and credentials. (USE ACCS_DOMAIN ACCS_USER ACCS_PWD) alt text
  • Type: select Automatic which means auto deploy after a successful execution of the build job. Select your previously created job and its artifact to deploy.

Click Save.

Build and deploy the sample application

To initiate a deployment to Application Container Cloud Service now there are two options. You can Start deployment process using the newly created Deployment configuration. Click gear icon and select Start.

alt text

Other option is to fire a new Build Job execution which will deploy artifact after a successfull build. Go back to Build page and click the wrench icon belongs to Spring Boot sample application build job.

alt text

Both way deploys Spring Boot sample application on Application Container Cloud Service. You can check that the deployment was successful by logging to the dashboard with ACCS DOMAIN CREDENTIALS and selecting Service Console on Application Container Cloud Service. The Deployment may take even up to 5 minutes.

alt text

You should see your Spring Boot sample application in the list. Click the application's URL to test.

alt text

The Spring Boot sample application main page should look like this.

alt text

There are many other options to trigger this deploy process. For example build can be triggered by source changes or can be scheduled to specific time of the day.

+ Optional step: Make changes in the application

Prerequisites: Git client, Text editor

Clone your newly created Git repository hosted on Developer Cloud Service to your local machine using basic or your favourite Git tool. Make small changes for example in the JSP file. Push changes to DevCS remote repository, execute Build again and check the changes on the redeployed application.

Continue with Deploying APM Agent on Apache Tomcat based application and setting up Application Performance Monitoring