Category: DevOps

New version of DevCS got some nice new features

• supports dedicate build server(s)
• new pipeline and pipeline visualization
• docker builder
• integration with code scan / analysis

More details can be found in DevCS PM blog post
https://blogs.oracle.com/cloud-platform/oracle-developer-cloud-service-adds-docker,-pipelines,-and-more
and latest documentation
https://docs.oracle.com/en/cloud/paas/developer-cloud/csdwn/index.html

In this article, I’m going to briefly walk through how to create and deploy a .net mvc sample app in Oracle Application Container Cloud Service.

Assumptions:

• you have an Oracle Cloud account, it can be the promotion trial account
• you have dotnet core installed on your local machine – I’m using dotnet 2.0.0 on MacOS
• you have the corresponding editor / tools, e.g. I’m using VS Code.

1. Launch VS Code and open the embedded Terminal. Alternatively, you can also use your favorite editor and/or the OS Terminal (in Windows, that will be the Command Window).

2. Create and goto (mkdir/cd)  your desire folder and create the mvc project – I will call the project accssample:

mkdir accssample
cd accssample
dotnet new mvc

1. Open Program.cs file of the project, add .UseContextRoot( )  and .UseUrls( ) in the CreateDefaultBuilder

.UseContentRoot(Directory.GetCurrentDirectory())

.UseUrls("http://*:"+ Environment.GetEnvironmentVariable("PORT"))

Remember to save the changes.

1. Use the terminal to update the project dependencies and create a debug build for local testing.

dotnet restore
dotnet build

1. Test the program locally

export PORT=8080
dotnet run

Open a browser and navigate to http://localhost:8080 to test the app locally

1. Once we are happy with the app, we can create the release build. We will need to publish to Linux release for ACCS.

dotnet publish -c Release -r linux-x64

1. For ACCS to start the program, we will create 2 more files in the distribution (i.e. linux-x64) folder

start.sh
manifest.json

Right click the linux-x64 folder and choose new file, name the first file as manifest.json

1. Enter the contents of manifest and remember to save it. For more info about ACCS manifest, please refer to ACCS documentation https://docs.oracle.com/en/cloud/paas/app-container-cloud/dvcjv/creating-meta-data-files.html

1. Repeat the same for the start.sh

1. In the terminal window, zip the release, start.sh and manifest.

cd bin/Release/netcoreapp2.0/linux-x64/
zip -rq accssample.zip manifest.json start.sh publish

1. The application is now ready to deploy to ACCS. We can either use Web GUI, CLI or REST API to deploy the app.

I’ve a small shell script to execute curl to send REST to deploy the app. I also have a deployment.json file to control the memory and number of instance of the app. The deployment json looks like this

{
        "memory":"1G",
        "instances":"1"
}

this is what I did to deploy the app to ACCS,

and this is what my script looks like – what I actually do is

• create a storage container
• put my the zip file in the container
• create an ACCS app from zip (in storage container)

1. We can double check the application deployment from ACCS WebUI (or using CLI / REST API)

1. Our sample app is now up and running in ACCS.

Last time, I posted the installation of GitLab. So, we have the Git…. what’s next?

A lot of people suggest CI – continuous integration. Thus, I’m going to talk about Jenkins in this post.

ASSUMPTION / PREREQUISITE:

• we have a BMCS subscription
• we already create a Linux VM or BM, have the VCN and Internet Gateway setup

We can put Jenkins in the same VM/BM as GitLab, or we can use another VM to run Jenkins.

Steps

1. Similar to GitLab, the first step here is to get the Jenkins installation binary. We can navigate to Oracle Cloud Marketplace
   https://cloudmarketplace.oracle.com/marketplace/en_US/listing/16132843
   for details
   
2. Just click the [Get App>] button and follow the instruction. It will guide us throughout the Jenkins installation process.
3. Actually, what we need to do is to ssh to the VM/BM to download and install Jenkins. In the VM/BM use wget to download Jenkins.
   
4. The download will take a while. wait for the download to complete. Then change the file permission to so that we can run the installer.
   
5. In our example, we will install Jenkins in the same VM/BM as GitLab. We will use non-privilliged port to run Jenkins and run it with oracle user.
   
6. The installer will install Gradle along with Jenkins.
   – Answer [Y] and press [Enter] when it ask for Gradle.
   – Answer [Y] and press [Enter] when it ask you to confirm.
   
7. Next, the installer will prompt you for installation folder. Enter your desired folder. In our example, we will put it under /u01
   
8. Enter your desired Jenkins SUPER ADMINISTRATION username and password
   
9. The installer will then ask you for Apache and Tomcat port to be used for Jenkins. You can just keep the default values.
   
10. Enter [Y] for the last confirmation and wait for the installation to complete.
    
11. Jenkins should starts automatically after the installation.

How to start / stop / restart Jenkins

Just navigate to the target folder and use the ctlcscript, e.g.

[oracle@kmean jenkins-2.60.2-0]$ ./ctlscripts.sh start

or

[oracle@kmean jenkins-2.60.2-0]$ ./ctlscripts.sh stop

How to access / navigate / login to Jenkins

It is simple, just use a browser and go to
http://your-vm-bm-ip-fqdn:apache-port/
e.g. http://jenkins.mydomain.com:8080/

Click the [Access Jenkins] link and login with the username/password we’ve entered during installation.

Register to Oracle Code Online for technical demonstrations and presentations from community advocates, Oracle ACEs, Product Leads and Java Champions. You will be able to chat instantaneously with any questions or comments about the presentation.

Oracle Code Online June 21st @09:30 IST

Register to our online event for technical demonstrations and presentations from community advocates, Oracle ACEs, Product Leads and Java Champions. You will be able to chat instantaneously with any questions or comments about the presentation.

EMEAPAC Champions