├── .gitignore
├── .mvn
    └── wrapper
    │   ├── maven-wrapper.jar
    │   └── maven-wrapper.properties
├── Dockerfile
├── LICENSE
├── README.md
├── ansible
    ├── ACI
    │   ├── aci_create.yml
    │   ├── aci_deploy.yml
    │   ├── aci_vars.yml
    │   ├── db_create.yml
    │   └── get_dbtoken.yml
    ├── AKS
    │   ├── aks_create.yml
    │   ├── aks_deploy.yml
    │   ├── aks_scale.yml
    │   ├── aks_vars.yml
    │   ├── db_create.yml
    │   ├── get_dbtoken.yml
    │   ├── k8s.yaml
    │   └── secret.yaml
    ├── VM
    │   ├── db_create.yml
    │   ├── get_dbtoken.yml
    │   ├── get_vm_host.yml
    │   ├── vm_create.yml
    │   ├── vm_deploy.yml
    │   └── vm_vars.yml
    └── VMSS
    │   ├── db_create.yml
    │   ├── get_dbtoken.yml
    │   ├── get_vmss_host.yml
    │   ├── vmss_create.yml
    │   ├── vmss_deploy.yml
    │   ├── vmss_scale.yml
    │   └── vmss_vars.yml
├── checkstyle.xml
├── deploy
    └── aks
    │   ├── Dockerfile
    │   ├── Jenkinsfile
    │   ├── deployment.yml
    │   ├── service.yml
    │   ├── setup
    │       ├── README.md
    │       ├── service-green.yml
    │       ├── setup.sh
    │       ├── test-endpoint-blue.yml
    │       └── test-endpoint-green.yml
    │   └── test-endpoint.yml
├── doc
    ├── deployment
    │   ├── deploy-to-AKS-blueegreen-using-jenkins.md
    │   ├── deploy-to-aks-with-acr-build-git-using-jenkins.md
    │   ├── deploy-to-aks-with-acr-build-local-using-jenkins.md
    │   ├── deploy-to-azure-container-service-using-jenkins.md
    │   ├── deploy-to-azure-container-service-using-maven-plugin.md
    │   ├── deploy-to-azure-web-app-javase-using-jenkins.md
    │   ├── deploy-to-azure-web-app-tomcat-using-jenkins.md
    │   ├── deploy-to-azure-web-app-using-eclipse-plugin.md
    │   ├── deploy-to-azure-web-app-using-intelliJ-plugin.md
    │   ├── deploy-to-azure-web-app-using-jenkins.md
    │   ├── deploy-to-azure-web-app-using-maven-plugin.md
    │   └── images
    │   │   └── publicip.png
    └── resources
    │   ├── fabric8
    │       ├── deployment.yml
    │       ├── secrets.yml
    │       └── service.yml
    │   └── jenkins
    │       ├── DockerfileWithMaven
    │       ├── Jenkinsfile-acr
    │       ├── Jenkinsfile-acr-with-git
    │       ├── Jenkinsfile-k8s
    │       ├── Jenkinsfile-webapp
    │       ├── Jenkinsfile-webapp-se
    │       ├── Jenkinsfile-webapp-tomcat
    │       ├── deployment.yml
    │       ├── jenkins-sample.yml
    │       ├── service.yml
    │       └── web.config
├── mvnw
├── mvnw.cmd
├── pom.xml
└── src
    ├── main
        ├── java
        │   └── com
        │   │   └── microsoft
        │   │       └── azure
        │   │           └── sample
        │   │               ├── TodoApplication.java
        │   │               ├── controller
        │   │                   └── TodoListController.java
        │   │               ├── dao
        │   │                   └── TodoItemRepository.java
        │   │               └── model
        │   │                   └── TodoItem.java
        └── resources
        │   ├── application.properties
        │   └── static
        │       ├── Scripts
        │           ├── app.js
        │           ├── homeCtrl.js
        │           ├── todoListCtrl.js
        │           └── todoListSvc.js
        │       ├── Views
        │           ├── Home.html
        │           └── TodoList.html
        │       └── index.html
    └── test
        ├── java
            └── com
            │   └── microsoft
            │       └── azure
            │           └── sample
            │               ├── TodoApplicationTest.java
            │               └── model
            │                   └── TodoItemTest.java
        └── resources
            └── test.properties


/.gitignore:
--------------------------------------------------------------------------------
 1 | target/
 2 | !.mvn/wrapper/maven-wrapper.jar
 3 | 
 4 | # Compiled class file
 5 | *.class
 6 | 
 7 | # Log file
 8 | *.log
 9 | 
10 | ### STS ###
11 | .apt_generated
12 | .classpath
13 | .factorypath
14 | .project
15 | .settings
16 | .springBeans
17 | 
18 | ### IntelliJ IDEA ###
19 | .idea
20 | *.iws
21 | *.iml
22 | *.ipr
23 | 
24 | # BlueJ files
25 | *.ctxt
26 | 
27 | # Mobile Tools for Java (J2ME)
28 | .mtj.tmp/
29 | 
30 | # Package Files #
31 | *.jar
32 | *.war
33 | *.ear
34 | *.zip
35 | *.tar.gz
36 | *.rar
37 | 
38 | ### Compiled ###
39 | *.dll
40 | 
41 | ### NetBeans ###
42 | nbproject/private/
43 | build/
44 | nbbuild/
45 | dist/
46 | nbdist/
47 | .nb-gradle/
48 | 
49 | 
50 | # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
51 | hs_err_pid*
52 | 


--------------------------------------------------------------------------------
/.mvn/wrapper/maven-wrapper.jar:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/microsoft/todo-app-java-on-azure/0544030ef592a09018fbb663d8ec59f682cdd2fc/.mvn/wrapper/maven-wrapper.jar


--------------------------------------------------------------------------------
/.mvn/wrapper/maven-wrapper.properties:
--------------------------------------------------------------------------------
1 | distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.5.0/apache-maven-3.5.0-bin.zip
2 | 


--------------------------------------------------------------------------------
/Dockerfile:
--------------------------------------------------------------------------------
1 | FROM openjdk
2 | VOLUME /tmp
3 | ADD target/*.jar /app.jar
4 | ENTRYPOINT [ "java", "-jar", "/app.jar", "--server.port=80" ]
5 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 |     MIT License
 2 | 
 3 |     Copyright (c) Microsoft Corporation. All rights reserved.
 4 | 
 5 |     Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |     of this software and associated documentation files (the "Software"), to deal
 7 |     in the Software without restriction, including without limitation the rights
 8 |     to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |     copies of the Software, and to permit persons to whom the Software is
10 |     furnished to do so, subject to the following conditions:
11 | 
12 |     The above copyright notice and this permission notice shall be included in all
13 |     copies or substantial portions of the Software.
14 | 
15 |     THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |     IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |     FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |     AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |     LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |     OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 |     SOFTWARE
22 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | # Todo App Java On Azure
  2 | 
  3 | This TodoList app is an Azure Java application. It provides end-to-end CRUD operation to todo list item from front-end AngularJS code. Behind the scene, todo list item data store is [Azure CosmosDB DocumentDB](https://docs.microsoft.com/en-us/azure/cosmos-db/documentdb-introduction). This application uses [Azure CosmosDB] (https://github.com/Azure/azure-cosmosdb-java), [Azure DocumentDB] (https://docs.microsoft.com/en-us/azure/cosmos-db/sql-api-introduction) [Spring Boot Starter](https://github.com/Microsoft/azure-spring-boot), and AngularJS to interact with Azure. This sample application provides several deployment options to deploy to Azure, pls see deployment section below. With Azure support in Spring Starters, maven plugins and Eclipse/IntelliJ plugins, Azure Java application development and deployment is effortless now.
  4 | 
  5 | 
  6 | ## TOC
  7 | 
  8 | * [Requirements](#requirements)
  9 | * [Create Azure Cosmos DB documentDB](#create-azure-cosmos-db-documentdb)
 10 | * [Configuration](#configuration)
 11 | * [Run it](#run-it)
 12 | * [Contribution](#contributing)
 13 | * Add new features
 14 |     * [Add AAD](https://github.com/Microsoft/todo-app-java-on-azure/tree/aad-start)
 15 |     * [Add KeyVault](https://github.com/Microsoft/todo-app-java-on-azure/tree/keyvault-secrets)
 16 | * Deployment
 17 |     * [Deploy to Azure Web App for Containers using IntelliJ plugin](./doc/deployment/deploy-to-azure-web-app-using-intelliJ-plugin.md)
 18 |     * [Deploy to Azure Web App for Containers using Eclipse plugin](./doc/deployment/deploy-to-azure-web-app-using-eclipse-plugin.md)
 19 |     * [Deploy to Azure Container Service Kubernetes cluster using Maven plugin](./doc/deployment/deploy-to-azure-container-service-using-maven-plugin.md)
 20 |     * [Deploy to Azure Web App for Containers using Maven plugin](./doc/deployment/deploy-to-azure-web-app-using-maven-plugin.md)
 21 |     * [Deploy to Azure Web App for Container using Jenkins](./doc/deployment/deploy-to-azure-web-app-using-jenkins.md)
 22 |     * [Deploy to Azure Web App for Java SE applications using Jenkins](./doc/deployment/deploy-to-azure-web-app-javase-using-jenkins.md)
 23 |     * [Deploy to Azure Web App for Tomcat using Jenkins](./doc/deployment/deploy-to-azure-web-app-tomcat-using-jenkins.md)
 24 |     * [Deploy to Azure Container Service using Jenkins](./doc/deployment/deploy-to-azure-container-service-using-jenkins.md)
 25 |     * [Deploy to AKS using Jenkins and Blue/Green Deployment](./doc/deployment/deploy-to-AKS-blueegreen-using-jenkins.md)
 26 |     * [Build Docker image from git repo in Azure Container Registry then deploy to Azure Kubernetes Service using Jenkins](./doc/deployment/deploy-to-aks-with-acr-build-git-using-jenkins.md)
 27 |     * [Build Docker image from local directory in Azure Container Registry then deploy to Azure Kubernetes Service using Jenkins](./doc/deployment/deploy-to-aks-with-acr-build-local-using-jenkins.md)
 28 | * [Useful link](#useful-link)
 29 | 
 30 | ## Requirements
 31 | 
 32 | * [JDK](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) 1.8 and above
 33 | * [Maven](https://maven.apache.org/) 3.0 and above
 34 | 
 35 | ## Create Azure Cosmos DB documentDB
 36 | 
 37 | You can follow our steps using [Azure CLI 2.0](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest) to deploy an Azure Cosmos DB documentDB,
 38 | or follow [this article](https://docs.microsoft.com/en-us/azure/cosmos-db/create-documentdb-java) to create it from Azure portal.
 39 | 
 40 | 1. login your Azure CLI, and set your subscription id 
 41 |     
 42 |     ```bash
 43 |     az login
 44 |     az account set -s <your-subscription-id>
 45 |     ```
 46 | 1. create an Azure Resource Group, and note your group name
 47 | 
 48 |     ```bash
 49 |     az group create -n <your-azure-group-name> -l <your-resource-group-region>
 50 |     ```
 51 | 
 52 | 1. create Azure Cosmos DB with DocumentDB kind. Note the `documentEndpoint` field in the response.
 53 | 
 54 |    ```bash
 55 |    az cosmosdb create --kind GlobalDocumentDB -g <your-azure-group-name> -n <your-azure-documentDB-name>
 56 |    ```
 57 |    **Note** name of cosmos db must be in lowercase.
 58 |    
 59 | 1. get your Azure Cosmos DB key, get the `primaryMasterKey` of the DocumentDB you just created.
 60 | 
 61 |     ```bash
 62 |     az cosmosdb list-keys -g <your-azure-group-name> -n <your-azure-documentDB-name>
 63 |     ```
 64 | 
 65 | ## Configuration
 66 | 
 67 | * Note your DocumentDB uri and key from last step, specify a database name but no need to create it.
 68 |   Then modify `src/main/resources/application.properties` file and save it.
 69 | 
 70 |     ``` txt
 71 |     azure.documentdb.uri=put-your-documentdb-uri-here
 72 |     azure.documentdb.key=put-your-documentdb-key-here
 73 |     azure.documentdb.database=put-your-documentdb-databasename-here
 74 |     ``` 
 75 | 
 76 | * If you don't want to modify configuration in the source code manually, you can put variables in this file and 
 77 |   set their values in system environment variables: `DOCUMENTDB_URI`, `DOCUMENTDB_KEY` and `DOCUMENTDB_DBNAME`.
 78 |   Then maven will substitute them during the build phase.
 79 |     ``` txt
 80 |     azure.documentdb.uri=@env.DOCUMENTDB_URI@
 81 |     azure.documentdb.key=@env.DOCUMENTDB_KEY@
 82 |     azure.documentdb.database=@env.DOCUMENTDB_DBNAME@
 83 |     ``` 
 84 | 
 85 | ## Run it
 86 | 
 87 | 1. package the project using `mvn package`
 88 | 1. Run the project using `java -jar target/todo-app-java-on-azure-1.0-SNAPSHOT.jar`
 89 | 1. Open `http://localhost:8080` you can see the web pages to show the todo list app
 90 | 
 91 | ## Clean up
 92 | 
 93 | Delete the Azure resources you created by running the following command:
 94 | 
 95 | ```bash
 96 | az group delete -y --no-wait -n <your-resource-group-name>
 97 | ```
 98 | 
 99 | ## Contributing
100 | 
101 | This project welcomes contributions and suggestions.  Most contributions require you to agree to a
102 | Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
103 | the rights to use your contribution. For details, visit https://cla.microsoft.com.
104 | 
105 | When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
106 | a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions
107 | provided by the bot. You will only need to do this once across all repos using our CLA.
108 | 
109 | This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
110 | For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
111 | contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
112 | 
113 | ## Useful link
114 | - [Azure Spring Boot Starters](https://github.com/Microsoft/azure-spring-boot)
115 | - [Azure Maven plugins](https://github.com/Microsoft/azure-maven-plugins)
116 | 


--------------------------------------------------------------------------------
/ansible/ACI/aci_create.yml:
--------------------------------------------------------------------------------
 1 | # Description
 2 | # ===========
 3 | # This playbook create an Azure Container Registry.
 4 | 
 5 | - hosts: localhost
 6 |   vars_files:
 7 |   - aci_vars.yml
 8 | 
 9 |   tasks:
10 |     - name: Create a resource group
11 |       azure_rm_resourcegroup:
12 |         name: "{{ resource_group }}"
13 |         location: "{{ location }}"
14 |     
15 |     - name: Create Azure Container Registry
16 |       azure_rm_containerregistry:
17 |         resource_group: "{{ resource_group }}"
18 |         name: "{{ registry_name}}"
19 |         admin_user_enabled: True
20 |         sku: Standard
21 |       
22 |     - include: db_create.yml


--------------------------------------------------------------------------------
/ansible/ACI/aci_deploy.yml:
--------------------------------------------------------------------------------
 1 | # Description
 2 | # ===========
 3 | # Use this playbook to 
 4 | # - git clone and build a sample java app into docker image
 5 | # - Push the image into ACR
 6 | # - Create an ACI instance
 7 | #
 8 | # Use aci_create playbook to create ACR first
 9 | #
10 | # Dependencies
11 | # ============
12 | # - maven on ansible host
13 | # - git on ansible host
14 | # - docker on ansible host
15 | 
16 | - hosts: localhost
17 |   vars_files:
18 |   - aci_vars.yml
19 |   
20 |   tasks:
21 |     - include: get_dbtoken.yml
22 |     
23 |     - name: Removing
24 |       file:
25 |         path: "{{ workspace }}"
26 |         state: absent
27 | 
28 |     - name: Git Clone
29 |       git:
30 |         repo: "{{ repo_url }}"
31 |         dest: "{{ workspace }}"
32 |       
33 |     - name: update uri
34 |       lineinfile:
35 |         dest: "{{ workspace }}/src/main/resources/application.properties"
36 |         regexp: '^azure.cosmosdb.uri='
37 |         line: "{{ dburi }}"
38 | 
39 |     - name: update key
40 |       lineinfile:
41 |         dest: "{{ workspace }}/src/main/resources/application.properties"
42 |         regexp: '^azure.cosmosdb.key='
43 |         line: "{{ dbkey }}"
44 | 
45 |     - name: update db name
46 |       lineinfile:
47 |         dest: "{{ workspace }}/src/main/resources/application.properties"
48 |         regexp: '^azure.cosmosdb.database='
49 |         line: "{{ dbstring }}"
50 | 
51 |     - name: Build sample app
52 |       shell: mvn package chdir="{{ workspace }}"
53 |       
54 |     - name: Get Azure Container Registry Password
55 |       azure_rm_containerregistry:
56 |         resource_group: "{{ resource_group }}"
57 |         name: "{{ registry_name}}"
58 |         admin_user_enabled: True
59 |         sku: Standard
60 |       register: acr_result
61 |     
62 |     - name: Login docker registry
63 |       docker_login:
64 |         registry: "{{ registry_name }}.azurecr.io"
65 |         username: "{{ registry_name }}"
66 |         password: "{{ acr_result.credentials.password }}"
67 |         email: "{{ email }}"
68 |     
69 |     - name: Docker Build and Push
70 |       docker_image:
71 |         path: "{{ workspace }}"
72 |         name: "{{ registry_name }}.azurecr.io/{{ image_name }}"
73 |         push: yes
74 |     
75 |     - name: Create Azure Container Instance
76 |       azure_rm_containerinstance:
77 |         resource_group: "{{ resource_group }}"
78 |         name: "{{ image_name }}"
79 |         ip_address: public
80 |         ports:
81 |           - "{{ http_port }}"
82 |         registry_login_server: "{{ registry_name }}.azurecr.io"
83 |         registry_username: "{{ registry_name }}"
84 |         registry_password: "{{ acr_result.credentials.password }}"
85 |         containers:
86 |           - name: "{{ image_name }}"
87 |             ports:
88 |               - "{{ http_port }}"
89 |             image: "{{ registry_name }}.azurecr.io/{{ image_name }}"


--------------------------------------------------------------------------------
/ansible/ACI/aci_vars.yml:
--------------------------------------------------------------------------------
 1 | ---
 2 | resource_group: tododemo_aci
 3 | location: eastus
 4 | registry_name: tododemoaciacr
 5 | repo_url: https://github.com/xiangyan99/todo-app-java-on-azure.git
 6 | workspace: ~/src/todo
 7 | image_name: tododemo
 8 | http_port: 80
 9 | email: test@email.com
10 | dbname: tododemoacidb


--------------------------------------------------------------------------------
/ansible/ACI/db_create.yml:
--------------------------------------------------------------------------------
 1 |     - name: Call REST API - DatabaseAccounts_CreateOrUpdate
 2 |       azure_rm_resource:
 3 |         # url: /subscriptions/{{ lookup('env','AZURE_SUBSCRIPTION_ID') }}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}
 4 |         api_version: '2015-04-08'
 5 |         resource_group: "{{ resource_group }}"
 6 |         provider: documentdb
 7 |         resource_type: databaseaccounts
 8 |         resource_name: "{{ dbname }}"
 9 |         body:
10 |           # Parameters to create and update Cosmos DB database accounts.
11 |           # A database account resource.
12 |           location: "{{ location }}"
13 |           tags: # Tags are a list of key-value pairs that describe the resource. These tags can be used in viewing and grouping this resource (across resource groups). A maximum of 15 tags can be provided for a resource. Each tag must have a key no greater than 128 characters and value no greater than 256 characters. For example, the default experience for a template type is set with "defaultExperience": "Cassandra". Current "defaultExperience" values also include "Table", "Graph", "DocumentDB", and "MongoDB".
14 |           kind: GlobalDocumentDB
15 |           properties:
16 |             databaseAccountOfferType: Standard
17 |     
18 |     - name: Wait for namespace to be ready
19 |       azure_rm_resource_facts:
20 |         api_version: '2015-04-08'
21 |         resource_group: "{{ resource_group }}"
22 |         provider: documentdb
23 |         resource_type: databaseaccounts
24 |         resource_name: "{{ dbname }}"
25 |       register: output
26 |       until: output.response[0].properties.readLocations[0].provisioningState == 'Succeeded'
27 |       delay: 100
28 | 
29 |     - name: Get cosmos db facts
30 |       azure_rm_resource_facts:
31 |         # url: /subscriptions/{{ lookup('env','AZURE_SUBSCRIPTION_ID') }}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}
32 |         api_version: '2015-04-08'
33 |         resource_group: "{{ resource_group }}"
34 |         provider: documentdb
35 |         resource_type: databaseaccounts
36 |         resource_name: "{{ dbname }}"
37 |       register: output
38 | 
39 |     - debug:
40 |         var: output


--------------------------------------------------------------------------------
/ansible/ACI/get_dbtoken.yml:
--------------------------------------------------------------------------------
 1 |     - name: Call REST API - DatabaseAccounts_ListKeys
 2 |       azure_rm_resource:
 3 |         url: /subscriptions/{{ AZURE_SUBSCRIPTION_ID }}/resourceGroups/{{ resource_group }}/providers/Microsoft.DocumentDB/databaseAccounts/{{ dbname }}/listKeys
 4 |         api_version: '2015-04-08'
 5 |         method: POST
 6 |       register: cosmosdb
 7 | 
 8 |     - name: Set DB facts
 9 |       set_fact:
10 |         dburi: 'azure.cosmosdb.uri=https://{{dbname}}.documents.azure.com:443'
11 |         dbkey: 'azure.cosmosdb.key={{cosmosdb.response.primaryMasterKey}}'
12 |         dbstring: 'azure.cosmosdb.database={{dbname}}'
13 | 
14 |     - debug:
15 |         msg: "{{dbkey}}"
16 |     
17 | 
18 | 


--------------------------------------------------------------------------------
/ansible/AKS/aks_create.yml:
--------------------------------------------------------------------------------
 1 | # Description
 2 | # ===========
 3 | # This playbook create an ACR, an AKS and deploy secrets into AKS
 4 | 
 5 | - hosts: localhost
 6 |   vars_files:
 7 |   - aks_vars.yml
 8 |       
 9 |   tasks:
10 |   - name: Create a resource group
11 |     azure_rm_resourcegroup:
12 |      name: "{{ resource_group }}"
13 |      location: "{{ location }}"
14 | 
15 |   - name: Create an AKS instance
16 |     azure_rm_aks:
17 |      name: "{{ resource_name }}"
18 |      resource_group: "{{ resource_group }}"
19 |      location: eastus
20 |      dns_prefix: "{{ resource_name }}"
21 |      service_principal:
22 |          client_id: "{{ AZURE_CLIENT_ID }}"
23 |          client_secret: "{{ AZURE_SECRET }}"
24 |      linux_profile:
25 |          admin_username: azureuser
26 |          ssh_key: "{{ SSH_PUBLIC_KEY }}"
27 |      agent_pool_profiles:
28 |          - name: default
29 |            count: 1
30 |            vm_size: Standard_DS1_v2
31 |     register: aks
32 | 
33 |   - name: Create Azure Container Registry
34 |     azure_rm_containerregistry:
35 |       resource_group: "{{ resource_group }}"
36 |       name: "{{ registry_name}}"
37 |       admin_user_enabled: True
38 |       sku: Standard
39 |     register: acr_result
40 | 
41 |   - name: Removing
42 |     file:
43 |       path: "{{ workspace }}"
44 |       state: absent
45 | 
46 |   - name: Git Clone
47 |     git:
48 |       repo: "{{ repo_url }}"
49 |       dest: "{{ workspace }}"
50 | 
51 |   - name: Login docker registry
52 |     docker_login:
53 |       registry: "{{ registry_name }}.azurecr.io"
54 |       username: "{{ registry_name }}"
55 |       password: "{{ acr_result.credentials.password }}"
56 |       email: "{{ email }}"
57 | 
58 |   - name: generate secret.yaml
59 |     shell: cat {{ workspace }}/ansible/AKS/secret.yaml | sed "s/dockersecret/$(cat ~/.docker/config.json | base64  | tr -d '\n')/g" > {{ workspace }}/ansible/AKS/secret1.yaml
60 | 
61 |   - name: Save kubeconfig
62 |     copy:
63 |       content: "{{ aks.kube_config }}"
64 |       dest: "{{ workspace }}/config"
65 |     
66 |   - name: Deploy secret
67 |     k8s_raw:
68 |       state: present
69 |       force: true
70 |       kubeconfig: "{{ workspace }}/config"
71 |       src: "{{ workspace }}/ansible/AKS/secret1.yaml"
72 |   
73 |   - include: db_create.yml


--------------------------------------------------------------------------------
/ansible/AKS/aks_deploy.yml:
--------------------------------------------------------------------------------
  1 | # Description
  2 | # ===========
  3 | # Use this playbook to 
  4 | # - git clone and build a sample java app into docker image
  5 | # - Push the image into ACR
  6 | # - Deploy the image into AKS
  7 | #
  8 | # Use aci_create playbook to create ACR first
  9 | #
 10 | # Dependencies
 11 | # ============
 12 | # - maven on ansible host
 13 | # - git on ansible host
 14 | # - docker on ansible host
 15 | 
 16 | - hosts: localhost
 17 |   vars_files:
 18 |   - aks_vars.yml
 19 |   
 20 |   tasks:
 21 |     - include: get_dbtoken.yml
 22 |     
 23 |     - name: Removing
 24 |       file:
 25 |         path: "{{ workspace }}"
 26 |         state: absent
 27 | 
 28 |     - name: Git Clone
 29 |       git:
 30 |         repo: "{{ repo_url }}"
 31 |         dest: "{{ workspace }}"
 32 |       
 33 |     - name: update uri
 34 |       lineinfile:
 35 |         dest: "{{ workspace }}/src/main/resources/application.properties"
 36 |         regexp: '^azure.cosmosdb.uri='
 37 |         line: "{{ dburi }}"
 38 | 
 39 |     - name: update key
 40 |       lineinfile:
 41 |         dest: "{{ workspace }}/src/main/resources/application.properties"
 42 |         regexp: '^azure.cosmosdb.key='
 43 |         line: "{{ dbkey }}"
 44 | 
 45 |     - name: update db name
 46 |       lineinfile:
 47 |         dest: "{{ workspace }}/src/main/resources/application.properties"
 48 |         regexp: '^azure.cosmosdb.database='
 49 |         line: "{{ dbstring }}"
 50 | 
 51 |     - name: Build sample app
 52 |       shell: mvn package chdir="{{ workspace }}"
 53 |       
 54 |     - name: Get Azure Container Registry Password
 55 |       azure_rm_containerregistry:
 56 |         resource_group: "{{ resource_group }}"
 57 |         name: "{{ registry_name }}"
 58 |         admin_user_enabled: True
 59 |         sku: Standard
 60 |       register: acr_result
 61 |     
 62 |     - name: Login docker registry
 63 |       docker_login:
 64 |         registry: "{{ registry_name }}.azurecr.io"
 65 |         username: "{{ registry_name }}"
 66 |         password: "{{ acr_result.credentials.password }}"
 67 |         email: "{{ email }}"
 68 |     
 69 |     - name: Docker Build and Push
 70 |       docker_image:
 71 |         path: "{{ workspace }}"
 72 |         name: "{{ registry_name }}.azurecr.io/{{ image_name }}"
 73 |         push: yes    
 74 | 
 75 |     - name: Get AKS config
 76 |       azure_rm_aks:
 77 |         name: "{{ resource_name }}"
 78 |         resource_group: "{{ resource_group }}"
 79 |         location: eastus
 80 |         dns_prefix: "{{ resource_name }}"
 81 |         service_principal:
 82 |           client_id: "{{ AZURE_CLIENT_ID }}"
 83 |           client_secret: "{{ AZURE_SECRET }}"
 84 |         linux_profile:
 85 |           admin_username: azureuser
 86 |           ssh_key: "{{ SSH_PUBLIC_KEY }}"
 87 |         agent_pool_profiles:
 88 |           - name: default
 89 |             count: 1
 90 |             vm_size: Standard_DS1_v2
 91 |       register: aks
 92 | 
 93 |     - name: Save kubeconfig
 94 |       copy:
 95 |         content: "{{ aks.kube_config }}"
 96 |         dest: "{{ workspace }}/config"
 97 | 
 98 |     - name: Prepare k8s.yaml
 99 |       shell: sed -e "s/YourACRName/{{ registry_name}}/g" -e "s/YourImageName/{{ image_name }}/g" {{ workspace }}/ansible/AKS/k8s.yaml > {{ workspace }}/ansible/AKS/k8s1.yaml
100 | 
101 |     - name: Deploy to AKS
102 |       k8s_raw:
103 |         state: present
104 |         force: true
105 |         kubeconfig: "{{ workspace }}/config"
106 |         src: "{{ workspace }}/ansible/AKS/k8s1.yaml"


--------------------------------------------------------------------------------
/ansible/AKS/aks_scale.yml:
--------------------------------------------------------------------------------
 1 | ---
 2 | - hosts: localhost
 3 |   vars_files:
 4 |   - aks_vars.yml
 5 |   
 6 |   tasks:
 7 |   - name: Scale the AKS instance agent count from 1 to 2
 8 |     azure_rm_aks:
 9 |      name: "{{ resource_name }}"
10 |      resource_group: "{{ resource_group }}"
11 |      location: eastus
12 |      dns_prefix: "{{ resource_name }}"
13 |      service_principal:
14 |          client_id: "{{ AZURE_CLIENT_ID }}"
15 |      linux_profile:
16 |          admin_username: azureuser
17 |          ssh_key: "{{ SSH_PUBLIC_KEY }}"
18 |      agent_pool_profiles:
19 |          - name: default
20 |            count: 2
21 |            vm_size: Standard_DS1_v2


--------------------------------------------------------------------------------
/ansible/AKS/aks_vars.yml:
--------------------------------------------------------------------------------
 1 | ---
 2 | resource_group: tododemo_aks
 3 | resource_name: tododemoaks
 4 | location: eastus
 5 | AZURE_CLIENT_ID: your_azure_client_id
 6 | AZURE_SECRET: your_azure_secret
 7 | SSH_PUBLIC_KEY: your_ssh_key
 8 | registry_name: tododemoaksacr
 9 | image_name: tododemo
10 | workspace: ~/src/todo
11 | repo_url: https://github.com/xiangyan99/todo-app-java-on-azure.git
12 | email: test@email.com
13 | dbname: tododemoaksdb


--------------------------------------------------------------------------------
/ansible/AKS/db_create.yml:
--------------------------------------------------------------------------------
 1 |     - name: Call REST API - DatabaseAccounts_CreateOrUpdate
 2 |       azure_rm_resource:
 3 |         # url: /subscriptions/{{ lookup('env','AZURE_SUBSCRIPTION_ID') }}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}
 4 |         api_version: '2015-04-08'
 5 |         resource_group: "{{ resource_group }}"
 6 |         provider: documentdb
 7 |         resource_type: databaseaccounts
 8 |         resource_name: "{{ dbname }}"
 9 |         body:
10 |           # Parameters to create and update Cosmos DB database accounts.
11 |           # A database account resource.
12 |           location: "{{ location }}"
13 |           tags: # Tags are a list of key-value pairs that describe the resource. These tags can be used in viewing and grouping this resource (across resource groups). A maximum of 15 tags can be provided for a resource. Each tag must have a key no greater than 128 characters and value no greater than 256 characters. For example, the default experience for a template type is set with "defaultExperience": "Cassandra". Current "defaultExperience" values also include "Table", "Graph", "DocumentDB", and "MongoDB".
14 |           kind: GlobalDocumentDB
15 |           properties:
16 |             databaseAccountOfferType: Standard
17 |     
18 |     - name: Wait for namespace to be ready
19 |       azure_rm_resource_facts:
20 |         api_version: '2015-04-08'
21 |         resource_group: "{{ resource_group }}"
22 |         provider: documentdb
23 |         resource_type: databaseaccounts
24 |         resource_name: "{{ dbname }}"
25 |       register: output
26 |       until: output.response[0].properties.readLocations[0].provisioningState == 'Succeeded'
27 |       delay: 100
28 | 
29 |     - name: Get cosmos db facts
30 |       azure_rm_resource_facts:
31 |         # url: /subscriptions/{{ lookup('env','AZURE_SUBSCRIPTION_ID') }}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}
32 |         api_version: '2015-04-08'
33 |         resource_group: "{{ resource_group }}"
34 |         provider: documentdb
35 |         resource_type: databaseaccounts
36 |         resource_name: "{{ dbname }}"
37 |       register: output
38 | 
39 |     - debug:
40 |         var: output


--------------------------------------------------------------------------------
/ansible/AKS/get_dbtoken.yml:
--------------------------------------------------------------------------------
 1 |     - name: Call REST API - DatabaseAccounts_ListKeys
 2 |       azure_rm_resource:
 3 |         url: /subscriptions/{{ AZURE_SUBSCRIPTION_ID }}/resourceGroups/{{ resource_group }}/providers/Microsoft.DocumentDB/databaseAccounts/{{ dbname }}/listKeys
 4 |         api_version: '2015-04-08'
 5 |         method: POST
 6 |       register: cosmosdb
 7 | 
 8 |     - name: Set DB facts
 9 |       set_fact:
10 |         dburi: 'azure.cosmosdb.uri=https://{{dbname}}.documents.azure.com:443'
11 |         dbkey: 'azure.cosmosdb.key={{cosmosdb.response.primaryMasterKey}}'
12 |         dbstring: 'azure.cosmosdb.database={{dbname}}'
13 | 
14 |     - debug:
15 |         msg: "{{dbkey}}"
16 |     
17 | 
18 | 


--------------------------------------------------------------------------------
/ansible/AKS/k8s.yaml:
--------------------------------------------------------------------------------
 1 | ---
 2 | kind: Deployment
 3 | apiVersion: extensions/v1beta1
 4 | metadata:
 5 |   name: tododemo
 6 |   namespace: default
 7 |   labels:
 8 |     app: tododemo
 9 | spec:
10 |   replicas: 1
11 |   selector:
12 |     matchLabels:
13 |       app: tododemo
14 |   template:
15 |     metadata:
16 |       name: tododemo
17 |       labels:
18 |         app: tododemo
19 |     spec:
20 |       containers:
21 |       - name: tododemo
22 |         image: YourACRName.azurecr.io/YourImageName
23 |         imagePullPolicy: Always
24 |       imagePullSecrets:
25 |       - name: regsecret
26 |   strategy:
27 |     type: RollingUpdate
28 |     rollingUpdate:
29 |       maxUnavailable: 1
30 |       maxSurge: 1
31 | 
32 | ---
33 | kind: Service
34 | apiVersion: v1
35 | metadata:
36 |   name: tododemo
37 |   namespace: default
38 |   labels:
39 |     app: tododemo
40 | spec:
41 |   ports:
42 |   - name: tcp-80-80-z4417
43 |     protocol: TCP
44 |     port: 80
45 |     targetPort: 80
46 |   selector:
47 |     app: tododemo
48 |   type: LoadBalancer


--------------------------------------------------------------------------------
/ansible/AKS/secret.yaml:
--------------------------------------------------------------------------------
1 | apiVersion: v1
2 | kind: Secret
3 | metadata:
4 |  name: regsecret
5 |  namespace: default
6 | data:
7 |  .dockerconfigjson: dockersecret
8 | type: kubernetes.io/dockerconfigjson


--------------------------------------------------------------------------------
/ansible/VM/db_create.yml:
--------------------------------------------------------------------------------
 1 |     - name: Call REST API - DatabaseAccounts_CreateOrUpdate
 2 |       azure_rm_resource:
 3 |         # url: /subscriptions/{{ lookup('env','AZURE_SUBSCRIPTION_ID') }}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}
 4 |         api_version: '2015-04-08'
 5 |         resource_group: "{{ resource_group }}"
 6 |         provider: documentdb
 7 |         resource_type: databaseaccounts
 8 |         resource_name: "{{ dbname }}"
 9 |         body:
10 |           # Parameters to create and update Cosmos DB database accounts.
11 |           # A database account resource.
12 |           location: "{{ location }}"
13 |           tags: # Tags are a list of key-value pairs that describe the resource. These tags can be used in viewing and grouping this resource (across resource groups). A maximum of 15 tags can be provided for a resource. Each tag must have a key no greater than 128 characters and value no greater than 256 characters. For example, the default experience for a template type is set with "defaultExperience": "Cassandra". Current "defaultExperience" values also include "Table", "Graph", "DocumentDB", and "MongoDB".
14 |           kind: GlobalDocumentDB
15 |           properties:
16 |             databaseAccountOfferType: Standard
17 |     
18 |     - name: Wait for namespace to be ready
19 |       azure_rm_resource_facts:
20 |         api_version: '2015-04-08'
21 |         resource_group: "{{ resource_group }}"
22 |         provider: documentdb
23 |         resource_type: databaseaccounts
24 |         resource_name: "{{ dbname }}"
25 |       register: output
26 |       until: output.response[0].properties.readLocations[0].provisioningState == 'Succeeded'
27 |       delay: 100
28 | 
29 |     - name: Get cosmos db facts
30 |       azure_rm_resource_facts:
31 |         # url: /subscriptions/{{ lookup('env','AZURE_SUBSCRIPTION_ID') }}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}
32 |         api_version: '2015-04-08'
33 |         resource_group: "{{ resource_group }}"
34 |         provider: documentdb
35 |         resource_type: databaseaccounts
36 |         resource_name: "{{ dbname }}"
37 |       register: output
38 | 
39 |     - debug:
40 |         var: output


--------------------------------------------------------------------------------
/ansible/VM/get_dbtoken.yml:
--------------------------------------------------------------------------------
 1 |     - name: Call REST API - DatabaseAccounts_ListKeys
 2 |       azure_rm_resource:
 3 |         url: /subscriptions/{{ AZURE_SUBSCRIPTION_ID }}/resourceGroups/{{ resource_group }}/providers/Microsoft.DocumentDB/databaseAccounts/{{ dbname }}/listKeys
 4 |         api_version: '2015-04-08'
 5 |         method: POST
 6 |       register: cosmosdb
 7 | 
 8 |     - name: Set DB facts
 9 |       set_fact:
10 |         dburi: 'azure.cosmosdb.uri=https://{{dbname}}.documents.azure.com:443'
11 |         dbkey: 'azure.cosmosdb.key={{cosmosdb.response.primaryMasterKey}}'
12 |         dbstring: 'azure.cosmosdb.database={{dbname}}'
13 | 
14 |     - debug:
15 |         msg: "{{dbkey}}"
16 |     
17 | 
18 | 


--------------------------------------------------------------------------------
/ansible/VM/get_vm_host.yml:
--------------------------------------------------------------------------------
 1 | # Description
 2 | # ===========
 3 | # This is a helper playbook used by other playbooks.
 4 | # Don't use it directly
 5 | 
 6 | - name: Get facts for all Public IPs within a resource groups
 7 |   azure_rm_publicipaddress_facts:
 8 |     resource_group: "{{ resource_group }}"
 9 |   register: output_ip_address
10 | 
11 | - debug:
12 |     var: output_ip_address
13 | 
14 | - name: Get list of all VMs
15 |   add_host:
16 |     groups: vmhost
17 |     hostname: "{{ output_ip_address.ansible_facts.azure_publicipaddresses[0].properties.ipAddress }}"
18 |     ansible_host: "{{ output_ip_address.ansible_facts.azure_publicipaddresses[0].properties.ipAddress }}"
19 |     ansible_port: 22
20 |     ansible_ssh_user: "{{ admin_username }}"
21 |     ansible_ssh_pass: "{{ admin_password }}"
22 | 


--------------------------------------------------------------------------------
/ansible/VM/vm_create.yml:
--------------------------------------------------------------------------------
 1 | # Description
 2 | # ===========
 3 | # This playbook create an Azure VM with public IP, and open 22 port for SSH
 4 | 
 5 | - name: Create Azure VM
 6 |   hosts: localhost
 7 |   connection: local
 8 |   vars_files:
 9 |   - vm_vars.yml
10 |   tasks:
11 |   - name: Create a resource group
12 |     azure_rm_resourcegroup:
13 |       name: "{{ resource_group }}"
14 |       location: "{{ location }}"
15 |   - name: Create virtual network
16 |     azure_rm_virtualnetwork:
17 |       resource_group: "{{ resource_group }}"
18 |       name: "{{ vm_name }}"
19 |       address_prefixes: "10.0.0.0/16"
20 |   - name: Add subnet
21 |     azure_rm_subnet:
22 |       resource_group: "{{ resource_group }}"
23 |       name: "{{ vm_name }}"
24 |       address_prefix: "10.0.1.0/24"
25 |       virtual_network: "{{ vm_name }}"
26 |   - name: Create public IP address
27 |     azure_rm_publicipaddress:
28 |       resource_group: "{{ resource_group }}"
29 |       allocation_method: Static
30 |       name: "{{ vm_name }}"
31 |   - name: Create Network Security Group that allows SSH
32 |     azure_rm_securitygroup:
33 |       resource_group: "{{ resource_group }}"
34 |       name: "{{ vm_name }}"
35 |       rules:
36 |         - name: SSH
37 |           protocol: Tcp
38 |           destination_port_range: 22
39 |           access: Allow
40 |           priority: 1001
41 |           direction: Inbound
42 |         - name: tomcat
43 |           protocol: Tcp
44 |           destination_port_range: 8080
45 |           access: Allow
46 |           priority: 1002
47 |           direction: Inbound
48 |   - name: Create virtual network inteface card
49 |     azure_rm_networkinterface:
50 |       resource_group: "{{ resource_group }}"
51 |       name: "{{ vm_name }}"
52 |       virtual_network: "{{ vm_name }}"
53 |       subnet: "{{ vm_name }}"
54 |       public_ip_name: "{{ vm_name }}"
55 |       security_group: "{{ vm_name }}"
56 |   - name: Create VM
57 |     azure_rm_virtualmachine:
58 |       resource_group: "{{ resource_group }}"
59 |       name: "{{ vm_name }}"
60 |       vm_size: Standard_DS1_v2
61 |       admin_username: "{{ admin_username }}"
62 |       admin_password: "{{ admin_password }}"
63 |       network_interfaces: "{{ vm_name }}"
64 |       image:
65 |         offer: UbuntuServer
66 |         publisher: Canonical
67 |         sku: 16.04-LTS
68 |         version: latest
69 |   - include: db_create.yml


--------------------------------------------------------------------------------
/ansible/VM/vm_deploy.yml:
--------------------------------------------------------------------------------
 1 | # Description
 2 | # ===========
 3 | # This playbook build the sample application and deploy it into VM
 4 | 
 5 | - hosts: localhost
 6 |   vars_files:
 7 |   - vm_vars.yml
 8 | 
 9 |   tasks:   
10 |     - include: get_vm_host.yml
11 | 
12 |     - include: get_dbtoken.yml
13 | 
14 |     - name: Removing
15 |       file:
16 |         path: "{{ workspace }}"
17 |         state: absent
18 | 
19 |     - name: Git Clone sample app
20 |       git:
21 |         repo: "{{ repo_url }}"
22 |         dest: "{{ workspace }}"
23 | 
24 |     - name: update uri
25 |       lineinfile:
26 |         dest: "{{ workspace }}/src/main/resources/application.properties"
27 |         regexp: '^azure.cosmosdb.uri='
28 |         line: "{{ dburi }}"
29 | 
30 |     - name: update key
31 |       lineinfile:
32 |         dest: "{{ workspace }}/src/main/resources/application.properties"
33 |         regexp: '^azure.cosmosdb.key='
34 |         line: "{{ dbkey }}"
35 | 
36 |     - name: update db name
37 |       lineinfile:
38 |         dest: "{{ workspace }}/src/main/resources/application.properties"
39 |         regexp: '^azure.cosmosdb.database='
40 |         line: "{{ dbstring }}"
41 | 
42 |     - name: Build sample app
43 |       shell: mvn package chdir="{{ workspace }}"
44 | 
45 | - name: Install JRE
46 |   hosts: vmhost
47 |   become: yes
48 |   vars_files:
49 |   - vm_vars.yml
50 | 
51 |   tasks:
52 |   - name: Install JRE
53 |     apt:
54 |       name: default-jre
55 |       update_cache: yes
56 | 
57 |   - name: Copy app to Azure VM
58 |     copy:
59 |       src: "{{ workspace }}/target/todo-app-java-on-azure-1.0-SNAPSHOT.jar"
60 |       dest: "/home/{{ admin_username }}/app.jar"
61 |       force: yes
62 |       mode: 0755
63 | 
64 |   - name: Start the app
65 |     shell: java -jar "/home/{{ admin_username }}/app.jar" --server.port=8080 >/dev/null 2>&1 &
66 |     async: 5000
67 |     poll: 0
68 | 
69 | 


--------------------------------------------------------------------------------
/ansible/VM/vm_vars.yml:
--------------------------------------------------------------------------------
1 | ---
2 | resource_group: tododemo_vm
3 | vm_name: tododemovm
4 | admin_username: your_user_name
5 | admin_password: your_password
6 | location: eastus
7 | repo_url: https://github.com/xiangyan99/todo-app-java-on-azure.git
8 | workspace: ~/src/todo
9 | dbname: tododemovmdb


--------------------------------------------------------------------------------
/ansible/VMSS/db_create.yml:
--------------------------------------------------------------------------------
 1 |     - name: Call REST API - DatabaseAccounts_CreateOrUpdate
 2 |       azure_rm_resource:
 3 |         # url: /subscriptions/{{ lookup('env','AZURE_SUBSCRIPTION_ID') }}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}
 4 |         api_version: '2015-04-08'
 5 |         resource_group: "{{ resource_group }}"
 6 |         provider: documentdb
 7 |         resource_type: databaseaccounts
 8 |         resource_name: "{{ dbname }}"
 9 |         body:
10 |           # Parameters to create and update Cosmos DB database accounts.
11 |           # A database account resource.
12 |           location: "{{ location }}"
13 |           tags: # Tags are a list of key-value pairs that describe the resource. These tags can be used in viewing and grouping this resource (across resource groups). A maximum of 15 tags can be provided for a resource. Each tag must have a key no greater than 128 characters and value no greater than 256 characters. For example, the default experience for a template type is set with "defaultExperience": "Cassandra". Current "defaultExperience" values also include "Table", "Graph", "DocumentDB", and "MongoDB".
14 |           kind: GlobalDocumentDB
15 |           properties:
16 |             databaseAccountOfferType: Standard
17 |     
18 |     - name: Wait for namespace to be ready
19 |       azure_rm_resource_facts:
20 |         api_version: '2015-04-08'
21 |         resource_group: "{{ resource_group }}"
22 |         provider: documentdb
23 |         resource_type: databaseaccounts
24 |         resource_name: "{{ dbname }}"
25 |       register: output
26 |       until: output.response[0].properties.readLocations[0].provisioningState == 'Succeeded'
27 |       delay: 100
28 | 
29 |     - name: Get cosmos db facts
30 |       azure_rm_resource_facts:
31 |         # url: /subscriptions/{{ lookup('env','AZURE_SUBSCRIPTION_ID') }}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}
32 |         api_version: '2015-04-08'
33 |         resource_group: "{{ resource_group }}"
34 |         provider: documentdb
35 |         resource_type: databaseaccounts
36 |         resource_name: "{{ dbname }}"
37 |       register: output
38 | 
39 |     - debug:
40 |         var: output


--------------------------------------------------------------------------------
/ansible/VMSS/get_dbtoken.yml:
--------------------------------------------------------------------------------
 1 |     - name: Call REST API - DatabaseAccounts_ListKeys
 2 |       azure_rm_resource:
 3 |         url: /subscriptions/{{ AZURE_SUBSCRIPTION_ID }}/resourceGroups/{{ resource_group }}/providers/Microsoft.DocumentDB/databaseAccounts/{{ dbname }}/listKeys
 4 |         api_version: '2015-04-08'
 5 |         method: POST
 6 |       register: cosmosdb
 7 | 
 8 |     - name: Set DB facts
 9 |       set_fact:
10 |         dburi: 'azure.cosmosdb.uri=https://{{dbname}}.documents.azure.com:443'
11 |         dbkey: 'azure.cosmosdb.key={{cosmosdb.response.primaryMasterKey}}'
12 |         dbstring: 'azure.cosmosdb.database={{dbname}}'
13 | 
14 |     - debug:
15 |         msg: "{{dbkey}}"
16 |     
17 | 
18 | 


--------------------------------------------------------------------------------
/ansible/VMSS/get_vmss_host.yml:
--------------------------------------------------------------------------------
 1 | # Description
 2 | # ===========
 3 | # This is a helper playbook used by other playbooks.
 4 | # Don't use it directly
 5 | 
 6 | - name: Get facts for all Public IPs within a resource groups
 7 |   azure_rm_publicipaddress_facts:
 8 |     resource_group: "{{ resource_group }}"
 9 |   register: output_ip_address
10 | 
11 | - name: Get loadbalancer info
12 |   azure_rm_loadbalancer_facts:
13 |     resource_group: "{{ resource_group }}"
14 |     name: "{{ lb_name }}"
15 |   register: output
16 | 
17 | - debug:
18 |     var: output
19 | 
20 | - name: Get list of all VMs
21 |   add_host:
22 |     groups: vmsshost
23 |     hostname: "{{ output_ip_address.ansible_facts.azure_publicipaddresses[0].properties.ipAddress }}_{{ item.properties.frontendPort }}"
24 |     ansible_host: "{{ output_ip_address.ansible_facts.azure_publicipaddresses[0].properties.ipAddress }}"
25 |     ansible_port: "{{ item.properties.frontendPort }}"
26 |     ansible_ssh_user: "{{ admin_username }}"
27 |     ansible_ssh_pass: "{{ admin_password }}"
28 |   with_items:
29 |     - "{{ output.ansible_facts.azure_loadbalancers[0].properties.inboundNatRules }}"


--------------------------------------------------------------------------------
/ansible/VMSS/vmss_create.yml:
--------------------------------------------------------------------------------
 1 | # Description
 2 | # ===========
 3 | # This playbook creates a Virtual Machine Scaleset.
 4 | # It also requires following env variables to be defined:
 5 | # - VMSS_ADMIN_USERNAME
 6 | # - VMSS_ADMIN_PASSWORD
 7 | # This sample requires Ansible 2.6 
 8 | 
 9 | ---
10 | - hosts: localhost
11 |   vars_files:
12 |   - vmss_vars.yml
13 | 
14 |   tasks:
15 |     - name: Create a resource group
16 |       azure_rm_resourcegroup:
17 |         name: "{{ resource_group }}"
18 |         location: "{{ location }}"
19 |     - name: Create virtual network
20 |       azure_rm_virtualnetwork:
21 |         resource_group: "{{ resource_group }}"
22 |         name: "{{ vmss_name }}"
23 |         address_prefixes: "10.0.0.0/16"
24 |     - name: Add subnet
25 |       azure_rm_subnet:
26 |         resource_group: "{{ resource_group }}"
27 |         name: "{{ vmss_name }}"
28 |         address_prefix: "10.0.1.0/24"
29 |         virtual_network: "{{ vmss_name }}"
30 |     - name: Create public IP address
31 |       azure_rm_publicipaddress:
32 |         resource_group: "{{ resource_group }}"
33 |         allocation_method: Static
34 |         name: "{{ vmss_name }}"
35 |     - name: Create Network Security Group that allows SSH
36 |       azure_rm_securitygroup:
37 |         resource_group: "{{ resource_group }}"
38 |         name: "{{ vmss_name }}"
39 |         rules:
40 |           - name: SSH
41 |             protocol: Tcp
42 |             destination_port_range: 22
43 |             access: Allow
44 |             priority: 1001
45 |             direction: Inbound
46 | 
47 |     - name: Create a load balancer
48 |       azure_rm_loadbalancer:
49 |         name: "{{ lb_name }}"
50 |         location: "{{ location }}"
51 |         resource_group: "{{ resource_group }}"
52 |         public_ip: "{{ vmss_name }}"
53 |         probe_protocol: Tcp
54 |         probe_port: 8080
55 |         probe_interval: 10
56 |         probe_fail_count: 3
57 |         protocol: Tcp
58 |         load_distribution: Default
59 |         frontend_port: 80
60 |         backend_port: 8080
61 |         idle_timeout: 4
62 |         natpool_frontend_port_start: 50000
63 |         natpool_frontend_port_end: 50040
64 |         natpool_backend_port: 22
65 |         natpool_protocol: Tcp
66 | 
67 |     - name: Create VMSS
68 |       azure_rm_virtualmachine_scaleset:
69 |         resource_group: "{{ resource_group }}"
70 |         name: "{{ vmss_name }}"
71 |         vm_size: Standard_DS1_v2
72 |         admin_username: "{{ admin_username }}"
73 |         admin_password: "{{ admin_password }}"
74 |         ssh_password_enabled: true
75 |         capacity: 2
76 |         virtual_network_name: "{{ vmss_name }}"
77 |         subnet_name: "{{ vmss_name }}"
78 |         upgrade_policy: Manual
79 |         tier: Standard
80 |         managed_disk_type: Standard_LRS
81 |         os_disk_caching: ReadWrite
82 |         image:
83 |           offer: UbuntuServer
84 |           publisher: Canonical
85 |           sku: 16.04-LTS
86 |           version: latest
87 |         load_balancer: "{{ lb_name }}"
88 |         data_disks:
89 |           - lun: 0
90 |             disk_size_gb: 20
91 |             managed_disk_type: Standard_LRS
92 |             caching: ReadOnly
93 |           - lun: 1
94 |             disk_size_gb: 30
95 |             managed_disk_type: Standard_LRS
96 |             caching: ReadOnly
97 |             
98 |     - include: db_create.yml


--------------------------------------------------------------------------------
/ansible/VMSS/vmss_deploy.yml:
--------------------------------------------------------------------------------
 1 | # Description
 2 | # ===========
 3 | # Use this playbook to 
 4 | # - git clone and build a sample hello world Spring java app
 5 | # - Install JRE on VMSS, 
 6 | # - then copy jar file to VMSS.
 7 | # - start the application.
 8 | #
 9 | # Use vmss-create playbook to create VMSS first
10 | # This sample requires Ansible 2.6 
11 | #
12 | # Dependencies
13 | # ============
14 | # - maven on ansible host
15 | # - git on ansible host
16 | 
17 | ---
18 | - hosts: localhost
19 |   vars_files:
20 |   - vmss_vars.yml
21 | 
22 |   tasks:   
23 |     - include: get_vmss_host.yml
24 | 
25 |     - include: get_dbtoken.yml
26 |     
27 |     - name: Removing
28 |       file:
29 |         path: "{{ workspace }}"
30 |         state: absent
31 | 
32 |     - name: Git Clone sample app
33 |       git:
34 |         repo: "{{ repo_url }}"
35 |         dest: "{{ workspace }}"
36 | 
37 |     - name: update uri
38 |       lineinfile:
39 |         dest: "{{ workspace }}/src/main/resources/application.properties"
40 |         regexp: '^azure.cosmosdb.uri='
41 |         line: "{{ dburi }}"
42 | 
43 |     - name: update key
44 |       lineinfile:
45 |         dest: "{{ workspace }}/src/main/resources/application.properties"
46 |         regexp: '^azure.cosmosdb.key='
47 |         line: "{{ dbkey }}"
48 | 
49 |     - name: update db name
50 |       lineinfile:
51 |         dest: "{{ workspace }}/src/main/resources/application.properties"
52 |         regexp: '^azure.cosmosdb.database='
53 |         line: "{{ dbstring }}"
54 | 
55 |     - name: Build sample app
56 |       shell: mvn package chdir="{{ workspace }}"
57 | 
58 | 
59 | - name: Install JRE on VMSS
60 |   hosts: vmsshost
61 |   become: yes
62 |   vars_files:
63 |   - vmss_vars.yml
64 | 
65 |   tasks:
66 |   - name: Install JRE
67 |     apt:
68 |       name: default-jre
69 |       update_cache: yes
70 | 
71 | 
72 |   - name: Copy app to Azure VM
73 |     copy:
74 |       src: "{{ workspace }}/target/todo-app-java-on-azure-1.0-SNAPSHOT.jar"
75 |       dest: "/home/{{ admin_username }}/app.jar"
76 |       force: yes
77 |       mode: 0755
78 | 
79 |   - name: Start the app
80 |     shell: java -jar "/home/{{ admin_username }}/app.jar" --server.port=8080 >/dev/null 2>&1 &
81 |     async: 5000
82 |     poll: 0
83 | 


--------------------------------------------------------------------------------
/ansible/VMSS/vmss_scale.yml:
--------------------------------------------------------------------------------
 1 | # Description
 2 | # ===========
 3 | # Use this playbook to scale up VMSS -- update number of VMs from 2 to 3.
 4 | # Use vmss-create playbook to create VMSS first
 5 | # This sample requires Ansible 2.6 
 6 | 
 7 | ---
 8 | - hosts: localhost
 9 |   vars_files:
10 |   - vmss_vars.yml
11 |   
12 |   tasks: 
13 |     - name: Get scaleset info
14 |       azure_rm_virtualmachine_scaleset_facts:
15 |         resource_group: "{{ resource_group }}"
16 |         name: "{{ vmss_name }}"
17 |         format: curated
18 |       register: output_scaleset
19 | 
20 |     - name: Dump scaleset info
21 |       debug:
22 |         var: output_scaleset
23 | 
24 |     - name: Modify scaleset (Change capacity to 3)
25 |       set_fact:
26 |         body: "{{ output_scaleset.ansible_facts.azure_vmss[0] | combine({'capacity': 3}, recursive=True) }}"
27 | 
28 |     - name: Update VMSS
29 |       azure_rm_virtualmachine_scaleset: "{{ body }}"


--------------------------------------------------------------------------------
/ansible/VMSS/vmss_vars.yml:
--------------------------------------------------------------------------------
 1 | ---
 2 | resource_group: tododemo_vmss
 3 | vmss_name: tododemovmss
 4 | location: eastus
 5 | admin_username: your_user_name
 6 | admin_password: your_password
 7 | lb_name: "{{ vmss_name }}_lb"
 8 | repo_url: https://github.com/xiangyan99/todo-app-java-on-azure.git
 9 | workspace: ~/src/todo
10 | dbname: tododemovmssdb


--------------------------------------------------------------------------------
/checkstyle.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | 
  3 | <!DOCTYPE module PUBLIC
  4 |         "-//Puppy Crawl//DTD Check Configuration 1.3//EN"
  5 |         "http://www.puppycrawl.com/dtds/configuration_1_3.dtd">
  6 | 
  7 | <!-- This is a checkstyle configuration file. For descriptions of
  8 | what the following rules do, please see the checkstyle configuration
  9 | page at http://checkstyle.sourceforge.net/config.html -->
 10 | 
 11 | <module name="Checker">
 12 | 
 13 |     <module name="SuppressionFilter">
 14 |     </module>
 15 | 
 16 |     <module name="Header">
 17 |         <property name="header"
 18 |                   value="/**\n * Copyright (c) Microsoft Corporation. All rights reserved.\n * Licensed under the MIT License. See LICENSE in the project root for\n * license information.\n */"/>
 19 |         <property name="fileExtensions" value="java, js"/>
 20 |     </module>
 21 | 
 22 |     <module name="FileTabCharacter">
 23 |         <!-- Checks that there are no tab characters in the file.
 24 |         -->
 25 |     </module>
 26 | 
 27 |     <module name="NewlineAtEndOfFile">
 28 |         <property name="lineSeparator" value="lf"/>
 29 |     </module>
 30 | 
 31 |     <module name="RegexpSingleline">
 32 |         <!-- Checks that FIXME is not used in comments.  TODO is preferred.
 33 |         -->
 34 |         <property name="format" value="((//.*)|(\*.*))FIXME"/>
 35 |         <property name="message"
 36 |                   value='TODO is preferred to FIXME.  e.g. "TODO(johndoe): Refactor when v2 is released."'/>
 37 |     </module>
 38 | 
 39 |     <module name="RegexpSingleline">
 40 |         <!-- Checks that TODOs are named.  (Actually, just that they are followed
 41 |              by an open paren.)
 42 |         -->
 43 |         <property name="format" value="((//.*)|(\*.*))TODO [^(]"/>
 44 |         <property name="message"
 45 |                   value='All TODOs should be named.  e.g. "TODO (johndoe): Refactor when v2 is released."'/>
 46 |     </module>
 47 | 
 48 |     <!-- All Java AST specific tests live under TreeWalker module. -->
 49 |     <module name="TreeWalker">
 50 | 
 51 |         <!--
 52 | 
 53 |         IMPORT CHECKS
 54 | 
 55 |         -->
 56 | 
 57 |         <module name="RedundantImport">
 58 |             <!-- Checks for redundant import statements. -->
 59 |             <property name="severity" value="error"/>
 60 |         </module>
 61 | 
 62 |         <!--
 63 | 
 64 |         NAMING CHECKS
 65 | 
 66 |         -->
 67 | 
 68 |         <!-- Item 38 - Adhere to generally accepted naming conventions -->
 69 | 
 70 |         <module name="PackageName">
 71 |             <!-- Validates identifiers for package names against the
 72 |               supplied expression. -->
 73 |             <!-- Here the default checkstyle rule restricts package name parts to
 74 |               seven characters, this is not in line with common practice at Google.
 75 |             -->
 76 |             <property name="format" value="^[a-z]+(\.[a-z][a-z0-9]{1,})*$"/>
 77 |             <property name="severity" value="warning"/>
 78 |         </module>
 79 | 
 80 |         <module name="TypeNameCheck">
 81 |             <!-- Validates static, final fields against the
 82 |             expression "^[A-Z][a-zA-Z0-9]*$". -->
 83 |             <metadata name="altname" value="TypeName"/>
 84 |             <property name="severity" value="warning"/>
 85 |         </module>
 86 | 
 87 |         <module name="ConstantNameCheck">
 88 |             <!-- Validates non-private, static, final fields against the supplied
 89 |             public/package final fields "^[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$". -->
 90 |             <metadata name="altname" value="ConstantName"/>
 91 |             <property name="applyToPublic" value="true"/>
 92 |             <property name="applyToProtected" value="true"/>
 93 |             <property name="applyToPackage" value="true"/>
 94 |             <property name="applyToPrivate" value="false"/>
 95 |             <property name="format" value="^([A-Z][A-Z0-9]*(_[A-Z0-9]+)*|FLAG_.*)$"/>
 96 |             <message key="name.invalidPattern"
 97 |                      value="Variable ''{0}'' should be in ALL_CAPS (if it is a constant) or be private (otherwise)."/>
 98 |             <property name="severity" value="warning"/>
 99 |         </module>
100 | 
101 |         <module name="StaticVariableNameCheck">
102 |             <!-- Validates static, non-final fields against the supplied
103 |             expression "^[a-z][a-zA-Z0-9]*_?$". -->
104 |             <metadata name="altname" value="StaticVariableName"/>
105 |             <property name="applyToPublic" value="true"/>
106 |             <property name="applyToProtected" value="true"/>
107 |             <property name="applyToPackage" value="true"/>
108 |             <property name="applyToPrivate" value="true"/>
109 |             <property name="format" value="^[a-z][a-zA-Z0-9]*_?$"/>
110 |             <property name="severity" value="warning"/>
111 |         </module>
112 | 
113 |         <module name="MemberNameCheck">
114 |             <!-- Validates non-static members against the supplied expression. -->
115 |             <metadata name="altname" value="MemberName"/>
116 |             <property name="applyToPublic" value="true"/>
117 |             <property name="applyToProtected" value="true"/>
118 |             <property name="applyToPackage" value="true"/>
119 |             <property name="applyToPrivate" value="true"/>
120 |             <property name="format" value="^[a-z][a-zA-Z0-9]*$"/>
121 |             <property name="severity" value="warning"/>
122 |         </module>
123 | 
124 |         <module name="MethodNameCheck">
125 |             <!-- Validates identifiers for method names. -->
126 |             <metadata name="altname" value="MethodName"/>
127 |             <property name="format" value="^[a-z][a-zA-Z0-9]*(_[a-zA-Z0-9]+)*$"/>
128 |             <property name="severity" value="warning"/>
129 |         </module>
130 | 
131 |         <module name="ParameterName">
132 |             <!-- Validates identifiers for method parameters against the
133 |               expression "^[a-z][a-zA-Z0-9]*$". -->
134 |             <property name="severity" value="warning"/>
135 |         </module>
136 | 
137 |         <module name="LocalFinalVariableName">
138 |             <!-- Validates identifiers for local final variables against the
139 |               expression "^[a-z][a-zA-Z0-9]*$". -->
140 |             <property name="severity" value="warning"/>
141 |         </module>
142 | 
143 |         <module name="LocalVariableName">
144 |             <!-- Validates identifiers for local variables against the
145 |               expression "^[a-z][a-zA-Z0-9]*$". -->
146 |             <property name="severity" value="warning"/>
147 |         </module>
148 | 
149 |         <module name="FinalLocalVariable">
150 |             <!-- Checks that local variables that never have their values changed are declared final. -->
151 |             <property name="tokens" value="VARIABLE_DEF"/>
152 |             <property name="validateEnhancedForLoopVariable" value="true"/>
153 |         </module>
154 | 
155 |         <!--
156 | 
157 |         LENGTH and CODING CHECKS
158 | 
159 |         -->
160 | 
161 |         <module name="LineLength">
162 |             <!-- Checks if a line is too long. -->
163 |             <property name="max" value="120"/>
164 |             <property name="severity" value="error"/>
165 | 
166 |             <!--
167 |               The default ignore pattern exempts the following elements:
168 |                 - import statements
169 |                 - long URLs inside comments
170 |             -->
171 | 
172 |             <property name="ignorePattern"
173 |                       value="${com.puppycrawl.tools.checkstyle.checks.sizes.LineLength.ignorePattern}"
174 |                       default="^(package .*;\s*)|(import .*;\s*)|( *\* *https?://.*)$"/>
175 |         </module>
176 | 
177 |         <module name="LeftCurly">
178 |             <!-- Checks for placement of the left curly brace ('{'). -->
179 |             <property name="severity" value="warning"/>
180 |         </module>
181 | 
182 |         <module name="RightCurly">
183 |             <!-- Checks right curlies on CATCH, ELSE, and TRY blocks are on
184 |             the same line. e.g., the following example is fine:
185 |             <pre>
186 |               if {
187 |                 ...
188 |               } else
189 |             </pre>
190 |             -->
191 |             <!-- This next example is not fine:
192 |             <pre>
193 |               if {
194 |                 ...
195 |               }
196 |               else
197 |             </pre>
198 |             -->
199 |             <property name="option" value="same"/>
200 |             <property name="severity" value="warning"/>
201 |         </module>
202 | 
203 |         <!-- Checks for braces around if and else blocks -->
204 |         <module name="NeedBraces">
205 |             <property name="severity" value="warning"/>
206 |             <property name="tokens" value="LITERAL_IF, LITERAL_ELSE, LITERAL_FOR, LITERAL_WHILE, LITERAL_DO"/>
207 |         </module>
208 | 
209 |         <module name="UpperEll">
210 |             <!-- Checks that long constants are defined with an upper ell.-->
211 |             <property name="severity" value="error"/>
212 |         </module>
213 | 
214 |         <module name="FallThrough">
215 |             <!-- Warn about falling through to the next case statement.  Similar to
216 |             javac -Xlint:fallthrough, but the check is suppressed if a single-line comment
217 |             on the last non-blank line preceding the fallen-into case contains 'fall through' (or
218 |             some other variants which we don't publicized to promote consistency).
219 |             -->
220 |             <property name="reliefPattern"
221 |                       value="fall through|Fall through|fallthru|Fallthru|falls through|Falls through|fallthrough|Fallthrough|No break|NO break|no break|continue on"/>
222 |             <property name="severity" value="error"/>
223 |         </module>
224 | 
225 | 
226 |         <!--
227 | 
228 |         MODIFIERS CHECKS
229 | 
230 |         -->
231 | 
232 |         <module name="ModifierOrder">
233 |             <!-- Warn if modifier order is inconsistent with JLS3 8.1.1, 8.3.1, and
234 |                  8.4.3.  The prescribed order is:
235 |                  public, protected, private, abstract, static, final, transient, volatile,
236 |                  synchronized, native, strictfp
237 |               -->
238 |         </module>
239 | 
240 | 
241 |         <!--
242 | 
243 |         WHITESPACE CHECKS
244 | 
245 |         -->
246 | 
247 |         <module name="WhitespaceAround">
248 |             <!-- Checks that various tokens are surrounded by whitespace.
249 |                  This includes most binary operators and keywords followed
250 |                  by regular or curly braces.
251 |             -->
252 |             <property name="tokens" value="ASSIGN, BAND, BAND_ASSIGN, BOR,
253 |         BOR_ASSIGN, BSR, BSR_ASSIGN, BXOR, BXOR_ASSIGN, COLON, DIV, DIV_ASSIGN,
254 |         EQUAL, GE, GT, LAND, LE, LITERAL_CATCH, LITERAL_DO, LITERAL_ELSE,
255 |         LITERAL_FINALLY, LITERAL_FOR, LITERAL_IF, LITERAL_RETURN,
256 |         LITERAL_SYNCHRONIZED, LITERAL_TRY, LITERAL_WHILE, LOR, LT, MINUS,
257 |         MINUS_ASSIGN, MOD, MOD_ASSIGN, NOT_EQUAL, PLUS, PLUS_ASSIGN, QUESTION,
258 |         SL, SL_ASSIGN, SR_ASSIGN, STAR, STAR_ASSIGN"/>
259 |             <property name="severity" value="error"/>
260 |         </module>
261 | 
262 |         <module name="WhitespaceAfter">
263 |             <!-- Checks that commas, semicolons and typecasts are followed by
264 |                  whitespace.
265 |             -->
266 |             <property name="tokens" value="COMMA, SEMI, TYPECAST"/>
267 |         </module>
268 | 
269 |         <module name="NoWhitespaceAfter">
270 |             <!-- Checks that there is no whitespace after various unary operators.
271 |                  Linebreaks are allowed.
272 |             -->
273 |             <property name="tokens" value="BNOT, DEC, DOT, INC, LNOT, UNARY_MINUS,
274 |         UNARY_PLUS"/>
275 |             <property name="allowLineBreaks" value="true"/>
276 |             <property name="severity" value="error"/>
277 |         </module>
278 | 
279 |         <module name="NoWhitespaceBefore">
280 |             <!-- Checks that there is no whitespace before various unary operators.
281 |                  Linebreaks are allowed.
282 |             -->
283 |             <property name="tokens" value="SEMI, DOT, POST_DEC, POST_INC"/>
284 |             <property name="allowLineBreaks" value="true"/>
285 |             <property name="severity" value="error"/>
286 |         </module>
287 | 
288 |         <module name="ParenPad">
289 |             <!-- Checks that there is no whitespace before close parens or after
290 |                  open parens.
291 |             -->
292 |             <property name="severity" value="warning"/>
293 |         </module>
294 | 
295 |     </module>
296 | </module>


--------------------------------------------------------------------------------
/deploy/aks/Dockerfile:
--------------------------------------------------------------------------------
1 | FROM java
2 | 
3 | ADD todo-app-*.jar /opt/app.jar
4 | 
5 | ENTRYPOINT [ "java", "-jar", "/opt/app.jar" ]


--------------------------------------------------------------------------------
/deploy/aks/Jenkinsfile:
--------------------------------------------------------------------------------
  1 | node('master') {
  2 | 
  3 |     def servicePrincipalId = '<your-service-principal>'
  4 |     def resourceGroup = '<your-resource-group-name>'
  5 |     def aks = '<your-kubernetes-cluster-name>'
  6 | 
  7 |     def cosmosResourceGroup = '<your-cosmodb-resource-group>'
  8 |     def cosmosDbName = '<your-cosmodb-name>'
  9 |     def dbName = '<your-dbname>'
 10 | 
 11 |     def dockerRegistry = '<your-acr-name>.azurecr.io'
 12 |     def imageName = "todo-app:${env.BUILD_NUMBER}"
 13 |     env.IMAGE_TAG = "${dockerRegistry}/${imageName}"
 14 |     def dockerCredentialId = '<your-acr-credential-id>'
 15 | 
 16 |     def currentEnvironment = 'blue'
 17 |     def newEnvironment = { ->
 18 |         currentEnvironment == 'blue' ? 'green' : 'blue'
 19 |     }
 20 | 
 21 |     stage('SCM') {
 22 |         checkout scm
 23 |     }
 24 | 
 25 |     stage('Build') {
 26 |         withCredentials([azureServicePrincipal(servicePrincipalId)]) {
 27 |             sh """
 28 |                 az login --service-principal -u "\$AZURE_CLIENT_ID" -p "\$AZURE_CLIENT_SECRET" -t "\$AZURE_TENANT_ID"
 29 |                 az account set --subscription "\$AZURE_SUBSCRIPTION_ID"
 30 | 
 31 |                 set +x
 32 |                 export DOCUMENTDB_URI="\$(az cosmosdb show -g "${cosmosResourceGroup}" -n "${cosmosDbName}" --query documentEndpoint -o tsv)"
 33 |                 export DOCUMENTDB_KEY="\$(az cosmosdb list-keys -g "${cosmosResourceGroup}" -n "${cosmosDbName}" --query primaryMasterKey -o tsv)"
 34 |                 export DOCUMENTDB_DBNAME="${dbName}"
 35 |                 set -x
 36 | 
 37 |                 sh ./mvnw clean package
 38 |                 az logout
 39 |             """
 40 |         }
 41 |     }
 42 | 
 43 |     stage('Docker Image') {
 44 |         withDockerRegistry([credentialsId: dockerCredentialId, url: "http://${dockerRegistry}"]) {
 45 |             dir('target') {
 46 |                 sh """
 47 |                     cp -f ../src/aks/Dockerfile .
 48 |                     docker build -t "${env.IMAGE_TAG}" .
 49 |                     docker push "${env.IMAGE_TAG}"
 50 |                 """
 51 |             }
 52 |         }
 53 |     }
 54 | 
 55 |     stage('Check Env') {
 56 |         // check the current active environment to determine the inactive one that will be deployed to
 57 | 
 58 |         withCredentials([azureServicePrincipal(servicePrincipalId)]) {
 59 |             // fetch the current service configuration
 60 |             sh """
 61 |               az login --service-principal -u "\$AZURE_CLIENT_ID" -p "\$AZURE_CLIENT_SECRET" -t "\$AZURE_TENANT_ID"
 62 |               az account set --subscription "\$AZURE_SUBSCRIPTION_ID"
 63 |               az aks get-credentials --resource-group "${resourceGroup}" --name "${aks}" --admin --file kubeconfig
 64 |               az logout
 65 |               current_role="\$(kubectl --kubeconfig kubeconfig get services todoapp-service --output json | jq -r .spec.selector.role)"
 66 |               if [ "\$current_role" = null ]; then
 67 |                   echo "Unable to determine current environment"
 68 |                   exit 1
 69 |               fi
 70 |               echo "\$current_role" >current-environment
 71 |             """
 72 |         }
 73 | 
 74 |         // parse the current active backend
 75 |         currentEnvironment = readFile('current-environment').trim()
 76 | 
 77 |         // set the build name
 78 |         echo "***************************  CURRENT: $currentEnvironment     NEW: ${newEnvironment()}  *****************************"
 79 |         currentBuild.displayName = newEnvironment().toUpperCase() + ' ' + imageName
 80 | 
 81 |         env.TARGET_ROLE = newEnvironment()
 82 | 
 83 |         // clean the inactive environment
 84 |         sh """
 85 |         kubectl --kubeconfig=kubeconfig delete deployment "todoapp-deployment-\$TARGET_ROLE"
 86 |         """
 87 |     }
 88 | 
 89 |     stage('Deploy') {
 90 |         // Apply the deployments to AKS.
 91 |         // With enableConfigSubstitution set to true, the variables ${TARGET_ROLE}, ${IMAGE_TAG}, ${KUBERNETES_SECRET_NAME}
 92 |         // will be replaced with environment variable values
 93 |         acsDeploy azureCredentialsId: servicePrincipalId,
 94 |                   resourceGroupName: resourceGroup,
 95 |                   containerService: "${aks} | AKS",
 96 |                   configFilePaths: 'src/aks/deployment.yml',
 97 |                   enableConfigSubstitution: true,
 98 |                   secretName: dockerRegistry,
 99 |                   containerRegistryCredentials: [[credentialsId: dockerCredentialId, url: "http://${dockerRegistry}"]]
100 |     }
101 | 
102 |     def verifyEnvironment = { service ->
103 |         sh """
104 |           endpoint_ip="\$(kubectl --kubeconfig=kubeconfig get services '${service}' --output json | jq -r '.status.loadBalancer.ingress[0].ip')"
105 |           count=0
106 |           while true; do
107 |               count=\$(expr \$count + 1)
108 |               if curl -m 10 "http://\$endpoint_ip"; then
109 |                   break;
110 |               fi
111 |               if [ "\$count" -gt 30 ]; then
112 |                   echo 'Timeout while waiting for the ${service} endpoint to be ready'
113 |                   exit 1
114 |               fi
115 |               echo "${service} endpoint is not ready, wait 10 seconds..."
116 |               sleep 10
117 |           done
118 |         """
119 |     }
120 | 
121 |     stage('Verify Staged') {
122 |         // verify the deployment through the corresponding test endpoint
123 |         verifyEnvironment("todoapp-test-${newEnvironment()}")
124 |     }
125 | 
126 |     stage('Switch') {
127 |         // Update the production service endpoint to route to the new environment.
128 |         // With enableConfigSubstitution set to true, the variables ${TARGET_ROLE}
129 |         // will be replaced with environment variable values
130 |         acsDeploy azureCredentialsId: servicePrincipalId,
131 |                   resourceGroupName: resourceGroup,
132 |                   containerService: "${aks} | AKS",
133 |                   configFilePaths: 'src/aks/service.yml',
134 |                   enableConfigSubstitution: true
135 |     }
136 | 
137 |     stage('Verify Prod') {
138 |         // verify the production environment is working properly
139 |         verifyEnvironment('todoapp-service')
140 |     }
141 | 
142 |     stage('Post-clean') {
143 |         sh '''
144 |           rm -f kubeconfig
145 |         '''
146 |     }
147 | }
148 | 


--------------------------------------------------------------------------------
/deploy/aks/deployment.yml:
--------------------------------------------------------------------------------
 1 | apiVersion: extensions/v1beta1
 2 | kind: Deployment
 3 | metadata:
 4 |   name: todoapp-deployment-${TARGET_ROLE}
 5 | spec:
 6 |   replicas: 2
 7 |   template:
 8 |     metadata:
 9 |       labels:
10 |         app: todoapp
11 |         role: ${TARGET_ROLE}
12 |     spec:
13 |       containers:
14 |       - name: todoapp-container
15 |         image: ${IMAGE_TAG}
16 |         ports:
17 |         - containerPort: 8080
18 |         readinessProbe:
19 |           httpGet:
20 |             path: /
21 |             port: 8080
22 |       imagePullSecrets:
23 |       - name: ${KUBERNETES_SECRET_NAME}
24 | 


--------------------------------------------------------------------------------
/deploy/aks/service.yml:
--------------------------------------------------------------------------------
 1 | kind: Service
 2 | apiVersion: v1
 3 | metadata:
 4 |   name: todoapp-service
 5 |   labels:
 6 |     app: todoapp
 7 |     role: ${TARGET_ROLE}
 8 |     env: prod
 9 | spec:
10 |   type: LoadBalancer
11 |   selector:
12 |     app: todoapp
13 |     role: ${TARGET_ROLE}
14 |   ports:
15 |     - port: 80
16 |       targetPort: 8080
17 | 


--------------------------------------------------------------------------------
/deploy/aks/setup/README.md:
--------------------------------------------------------------------------------
 1 | # Setup AKS
 2 | 
 3 | ## Command
 4 | 
 5 | ```sh
 6 | ./setup.sh
 7 | ```
 8 | 
 9 | ## Prerequisites
10 | 
11 | * Login Azure CLI
12 | 
13 |    ```sh
14 |    az login
15 |    ```
16 | 
17 | * Select the demos subscription
18 | 
19 |    ```sh
20 |    az account set --subscription "<subscription-id>"
21 |    ```
22 | 
23 | ## Actions Performed
24 | 
25 | * Create resource group `<your-resource-group-name>` if not exists
26 | * Create AKS `<your-kubernetes-cluster-name>` in resource group `<your-resource-group-name>` if not exists
27 | * Apply the Kubernetes resource configurations in this directory
28 | 
29 | 


--------------------------------------------------------------------------------
/deploy/aks/setup/service-green.yml:
--------------------------------------------------------------------------------
 1 | kind: Service
 2 | apiVersion: v1
 3 | metadata:
 4 |   name: todoapp-service
 5 |   labels:
 6 |     app: todoapp
 7 |     role: green
 8 |     env: prod
 9 | spec:
10 |   type: LoadBalancer
11 |   selector:
12 |     app: todoapp
13 |     role: green
14 |   ports:
15 |     - port: 80
16 |       targetPort: 8080
17 | 


--------------------------------------------------------------------------------
/deploy/aks/setup/setup.sh:
--------------------------------------------------------------------------------
 1 | #!/bin/bash
 2 | 
 3 | DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 4 | 
 5 | echo "Check Azure CLI login..."
 6 | if ! az group list >/dev/null 2>&1; then
 7 |     echo "Login Azure CLI required" >&2
 8 |     exit 1
 9 | fi
10 | 
11 | resource_group=<your-resource-group-name>
12 | location=<your-location>
13 | aks_name=<your-kubernetes-cluster-name>
14 | dns_name_suffix=<your-dns-name-suffix>
15 | companion_rg="MC_${resource_group}_${aks_name}_${location}"
16 | 
17 | echo "Checking resource group $resource_group..."
18 | if [[ "$(az group exists --name "$resource_group")" == "false" ]]; then
19 |     echo "Create resource group $resource_group"
20 |     az group create -n "$resource_group" -l "$location"
21 | fi
22 | 
23 | echo "Checking AKS $aks_name..."
24 | if ! az aks show -g "$resource_group" -n "$aks_name" >/dev/null 2>&1; then
25 |     echo "Create AKS $aks_name"
26 |     az aks create -g "$resource_group" -n "$aks_name" --node-count 2
27 | fi
28 | 
29 | kubeconfig="$(mktemp)"
30 | 
31 | echo "Fetch AKS credentials to $kubeconfig"
32 | az aks get-credentials -g "$resource_group" -n "$aks_name" --admin --file "$kubeconfig"
33 | 
34 | SAVEIFS="$IFS"
35 | IFS=$(echo -en "\n\b")
36 | for config in "$DIR"/*.yml; do
37 |     echo "Apply $config"
38 |     kubectl apply -f "$config" --kubeconfig "$kubeconfig"
39 | done
40 | IFS="$SAVEIFS"
41 | 
42 | function assign_dns {
43 |     service="$1"
44 |     dns_name="$2"
45 |     IP=
46 |     while true; do
47 |         echo "Waiting external IP for $service..."
48 |         IP="$(kubectl get service "$service" --kubeconfig "$kubeconfig" | tail -n +2 | awk '{print $4}' | grep -v '<')"
49 |         if [[ "$?" == 0 && -n "$IP" ]]; then
50 |             echo "Service $service public IP: $IP"
51 |             break
52 |         fi
53 |         sleep 10
54 |     done
55 | 
56 |     public_ip="$(az network public-ip list -g "$companion_rg" --query "[?ipAddress==\`$IP\`] | [0].id" -o tsv)"
57 |     if [[ -z "$public_ip" ]]; then
58 |         echo "Cannot find public IP resource ID for '$service' in companion resource group '$companion_rg'" >&2
59 |         exit 1
60 |     fi
61 | 
62 |     echo "Assign DNS name '$dns_name' for '$service'"
63 |     az network public-ip update --dns-name "$dns_name" --ids "$public_ip"
64 |     [[ $? != 0 ]] && exit 1
65 | }
66 | 
67 | assign_dns todoapp-service "aks-todoapp$dns_name_suffix"
68 | assign_dns todoapp-test-blue "aks-todoapp-blue$dns_name_suffix"
69 | assign_dns todoapp-test-green "aks-todoapp-green$dns_name_suffix"
70 | 
71 | rm -f "$kubeconfig"
72 | 
73 | 


--------------------------------------------------------------------------------
/deploy/aks/setup/test-endpoint-blue.yml:
--------------------------------------------------------------------------------
 1 | kind: Service
 2 | apiVersion: v1
 3 | metadata:
 4 |   name: todoapp-test-blue
 5 |   labels:
 6 |     app: todoapp
 7 |     role: test-blue
 8 | spec:
 9 |   type: LoadBalancer
10 |   selector:
11 |     app: todoapp
12 |     role: blue
13 |   ports:
14 |     - port: 80
15 |       targetPort: 8080
16 | 


--------------------------------------------------------------------------------
/deploy/aks/setup/test-endpoint-green.yml:
--------------------------------------------------------------------------------
 1 | kind: Service
 2 | apiVersion: v1
 3 | metadata:
 4 |   name: todoapp-test-green
 5 |   labels:
 6 |     app: todoapp
 7 |     role: test-green
 8 | spec:
 9 |   type: LoadBalancer
10 |   selector:
11 |     app: todoapp
12 |     role: green
13 |   ports:
14 |     - port: 80
15 |       targetPort: 8080
16 | 


--------------------------------------------------------------------------------
/deploy/aks/test-endpoint.yml:
--------------------------------------------------------------------------------
 1 | kind: Service
 2 | apiVersion: v1
 3 | metadata:
 4 |   name: todoapp-test-${TARGET_ROLE}
 5 |   labels:
 6 |     app: todoapp
 7 |     role: test-${TARGET_ROLE}
 8 | spec:
 9 |   type: LoadBalancer
10 |   selector:
11 |     app: todoapp
12 |     role: ${TARGET_ROLE}
13 |   ports:
14 |     - port: 80
15 |       targetPort: 8080
16 | 


--------------------------------------------------------------------------------
/doc/deployment/deploy-to-AKS-blueegreen-using-jenkins.md:
--------------------------------------------------------------------------------
  1 | # Deploy to AKS using Jenkins and blue/green deployment strategy
  2 | 
  3 | This document shows you how to deploy the todo app java project to AKS using Jenkins and blue/green deployment strategy. 
  4 | 
  5 | ## Fork the todo-app-java-on-azure repo
  6 | 
  7 | 1. Use git to download a copy of the application to your development environment.
  8 | 
  9 |     ```bash
 10 |     git clone https://github.com/microsoft/todo-app-java-on-azure.git
 11 |     ```
 12 | 
 13 | 2. Change directories so that you are working from the cloned directory. 
 14 | 
 15 | ## Create Azure services
 16 | 
 17 | You can create the Azure Services using [Azure CLI 2.0](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest). For AKS, please make sure Azure CLI is version 2.0.25 or later.
 18 | 
 19 | AKS is still in preview at the time when these instructions are created. You may need to enable the preview for your Azure subscription. Please refer to [this](https://docs.microsoft.com/en-us/azure/aks/kubernetes-walkthrough#enabling-aks-preview-for-your-azure-subscription) for more details.
 20 | 
 21 | ### Create AKS
 22 | 
 23 | 1. login your Azure CLI, and set your subscription id 
 24 |     
 25 |     ```bash
 26 |     az login
 27 |     az account set -s <your-subscription-id>
 28 |     ```
 29 | 
 30 | 1. Create a resource group. While AKS is in preview, only some location options are available. 
 31 | 
 32 |     ```bash
 33 |     az group create -n <your-resource-group-name> -l <your-location>
 34 |     ```
 35 | 
 36 | 1. Create AKS
 37 | 
 38 |     ```bash
 39 |     az aks create -g <your-resource-group-name> -n <your-kubernetes-cluster-name> --node-count 2
 40 |     ```
 41 | 
 42 | 1. Install [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) and [jq](https://stedolan.github.io/jq/download/), a lightweight command-line JSON processor.
 43 | 
 44 | ### Setting up AKS
 45 | 
 46 | Because we are doing blue/green deployment, we need to do some initial setup. You have two choices. 
 47 | 
 48 | #### Run the set up script
 49 | 1. Edit [set up script](/../deploy/aks/setup/setup.sh) and update `<your-resource-group-name>`, `<your-kubernetes-cluster-name>`,
 50 |    `<your-location>` and `<your-dns-name-suffix>` respectively:
 51 | 
 52 |     ``` bash   
 53 |     resource_group=<your-resource-group-name>
 54 |     location=<your-location>
 55 |     aks_name=<your-kubernetes-cluster-name>
 56 |     dns_name_suffix=<your-dns-name-suffix>
 57 |     ```
 58 | 
 59 | 2. Run the script. 
 60 | 
 61 | #### Set up manually 
 62 | 1. Download the Kubernetes configuration to your profile folder.
 63 | 
 64 |     ```bash
 65 |     az aks get-credentials -g <your-resource-group-name> -n <your-kubernetes-cluster-name> --admin
 66 |     ```
 67 | 
 68 | 2. Change directory to /deploy/aks/setup. Run the following kubectl commands to setup the services for
 69 |     the public end point and the two test end points:
 70 | 
 71 |     ```
 72 |     kubectl apply -f  service-green.yml
 73 |     kubectl apply -f  test-endpoint-blue.yml
 74 |     kubectl apply -f  test-endpoint-green.yml
 75 |     ```
 76 | 
 77 | 3. Update the public and test end points DNS names. When AKS is created, an [additional resource group](https://github.com/Azure/AKS/issues/3)
 78 |     is created. Look for resource group: `MC_<your-resource-group-name>_<your-kubernetes-cluster-name>_<your-location>`.
 79 | 
 80 |     Locate the public ip's in the resource group
 81 | 
 82 |     ![Public IP](images/publicip.png)
 83 | 
 84 |     For each of the services, find the external IP address by running:
 85 |     
 86 |     ```
 87 |     kubectl get service todoapp-service
 88 |     ```
 89 |     
 90 |     Update the DNS name for the corresponding IP address:
 91 | 
 92 |     ```
 93 |     az network public-ip update --dns-name aks-todoapp --ids /subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/MC_<resourcegroup>_<aks>_<location>/providers/Microsoft.Network/publicIPAddresses/kubernetes-AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
 94 |     ```
 95 | 
 96 |     Repeat for `todoapp-test-blue` and `todoapp-test-green`:
 97 |     ```
 98 |     az network public-ip update --dns-name todoapp-blue --ids /subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/MC_<resourcegroup>_<aks>_<location>/providers/Microsoft.Network/publicIPAddresses/kubernetes-BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
 99 | 
100 |     az network public-ip update --dns-name todoapp-green --ids /subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/resourceGroups/MC_<resourcegroup>_<aks>_<location>/providers/Microsoft.Network/publicIPAddresses/kubernetes-CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
101 |     ```
102 |     Note that the dns name needs to be unique in your subscription. `<your-dns-name-suffix>` can be used to ensure the uniqueness.
103 | 
104 | 
105 | ### Create Azure Container Registry
106 | 
107 | 1. Run below command to create an Azure Container Registry.
108 |     After creation, use `login server` as Docker registry URL in the next section.
109 | 
110 |     ```bash
111 |     az acr create -n <your-registry-name> -g <your-resource-group-name> --sku <sku-name> --admin-enabled true
112 |     ```
113 | 
114 | 1. Run below command to show your Azure Container Registry credentials.
115 |     You will use Docker registry username and password in the next section.
116 | 
117 |     ```bash
118 |     az acr credential show -n <your-registry-name>
119 |     ```
120 | 
121 | ## Prepare Jenkins server
122 | 1. Deploy a Jenkins Master on Azure [https://aka.ms/jenkins-on-azure]
123 | 
124 | 1. Connect to the server with SSH and install the build tools on the server where you will run your build:
125 |    
126 |    ```
127 |    sudo apt-get install git maven 
128 |    ```
129 |    
130 |    Install Docker by following the steps [here](https://docs.docker.com/install/linux/docker-ce/ubuntu/#install-docker-ce).
131 |    Make sure the user `jenkins` has permission to run the `docker` commands.
132 | 
133 | 1. Install additional tools needed for this example:
134 | 
135 |    * [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) 
136 |    * [jq](https://stedolan.github.io/jq/download/)
137 | 
138 |    ```
139 |    sudo apt-get install jq
140 |    ```
141 |    
142 | 1. Install the plugins in Jenkins. Click 'Manage Jenkins' -> 'Manage Plugins' -> 'Available', 
143 |     then search and install the following plugins: Azure Container Service Plugin.
144 | 
145 | 1. Add dd a Credential in type "Microsoft Azure Service Principal" with your service principal.
146 | 
147 | 1. Add a Credential in type "Username with password" with your account of docker registry.
148 | 
149 | ## Edit the Jenkinsfile
150 | 
151 | 1. In your own repo, navigate to /deploy/aks/ and open `Jenkinsfile`
152 | 
153 | 2. Update:
154 | 
155 |     ```groovy
156 |     def servicePrincipalId = '<your-service-principal>'
157 |     def resourceGroup = '<your-resource-group-name>'
158 |     def aks = '<your-kubernetes-cluster-name>'
159 | 
160 |     def cosmosResourceGroup = '<your-cosmodb-resource-group>'
161 |     def cosmosDbName = '<your-cosmodb-name>'
162 |     def dbName = '<your-dbname>'
163 | 
164 |     def dockerRegistry = '<your-acr-name>.azurecr.io'
165 |     ```
166 |     
167 |     And update ACR credential id
168 |     
169 |     ```
170 |     def dockerCredentialId = '<your-acr-credential-id>'
171 |     ```
172 | 
173 | ## Create job
174 | 1. Add a new job in type "Pipeline".
175 | 
176 | 1. Choose "Pipeline script from SCM" in "Pipeline" -> "Definition".
177 | 
178 | 1. Fill in the SCM repo url `your forked repo` and script path `deploy/aks/Jenkinsfile`
179 | 
180 | 
181 | ## Run it
182 | 1. Verify you can run your project successfully in your local environment. ([Run project on local machine](../../README.md))
183 | 
184 | 1. Run jenkins job. If you run this for the first time, Jenkins will deploy the todo app to the Blue environment which is the default inactive environment. 
185 | 
186 | 1. To verify, open the urls:
187 |     - Public end point: `http://aks-todoapp<your-dns-name-suffix>.<your-location>.cloudapp.azure.com`
188 |     - Blue end point - `http://aks-todoapp-blue<your-dns-name-suffix>.<your-location>.cloudapp.azure.com`
189 |     - Green end point - `http://aks-todoapp-green<your-dns-name-suffix>.<your-location>.cloudapp.azure.com`
190 | 
191 | The public and the Blue test end points have the same update while the Green end point shows the default tomcat image. 
192 | 
193 | If you run the build more than once, it will cycle through Blue and Green deployments. In other words, if the current environment is Blue, the job will deploy/test the Green environment and then update the application public endpoint to route traffic to the Green environment if all is good with testing.
194 | 
195 | ## Additional information
196 | 
197 | For more on zero-downtime deployment, please check out this [quickstart template](https://github.com/Azure/azure-quickstart-templates/tree/master/301-jenkins-aks-zero-downtime-deployment). 
198 | 
199 | ## Clean up
200 | 
201 | Delete the Azure resources you just created by running below command:
202 | 
203 | ```bash
204 | az group delete -y --no-wait -n <your-resource-group-name>
205 | ```
206 | 


--------------------------------------------------------------------------------
/doc/deployment/deploy-to-aks-with-acr-build-git-using-jenkins.md:
--------------------------------------------------------------------------------
  1 | # Build Docker image from git repo in Azure Container Registry then deploy to Azure Kubernetes Service using Jenkins
  2 | 
  3 | This document shows how to deploy this todo app java project to Kubernetes cluster using Jenkins. Instead of installing Docker on the build agent, you can use **Azure ACR Plugin** to build your Docker image in Azure Container Registry with your Github repo url.
  4 | 
  5 | On the Jenkins machine, it uses **Azure ACR PLugin** to queue an Azure Container Registry Quick build to build a todo-app-java-on-azure docker image, then apply the docker image to an Azure Kubernetes Service cluster with **Azure Container Agents Plugin**. 
  6 | 
  7 | > This deployment instruction will include Maven package in the Dockerfile. If you want to do the Maven package on your Jenkins Server instead during the docker build, please go to [Build Docker image from local directory in Azure Container Registry then deploy to Azure Kubernetes Service using Jenkins](./deploy-to-aks-with-acr-build-local-using-jenkins.md).
  8 | 
  9 | ## Run application on local machine
 10 | Verify you can run your project successfully in your local environment. ([Run project on local machine](../../README.md))
 11 | 
 12 | ## Create Azure services
 13 | 
 14 | You can create the Azure Services using [Azure CLI 2.0](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest).
 15 | 
 16 | 1. login your Azure CLI, and set your subscription id 
 17 |     
 18 |     ```bash
 19 |     az login
 20 |     az account set -s <your-subscription-id>
 21 |     ```
 22 | 
 23 | 1. Create a resource group
 24 | 
 25 |     ```bash
 26 |     az group create -n <your-resource-group-name> -l eastus
 27 |     ```
 28 | 
 29 | ### Create Azure Service Principal
 30 | 
 31 | 1. Create a service principal  and configure its access to all Azure resources under this subscription. Note all the information as service principal.
 32 | 
 33 |    ```bash
 34 |    az ad sp create-for-rbac
 35 |    ```
 36 |     
 37 | ### Create Azure Kubernetes Service
 38 | 
 39 | 1. Create Kubernetes cluster
 40 | 
 41 |     ```bash
 42 |     az aks create -g <your-resource-group-name> -n <your-kubernetes-cluster-name> --generate-ssh-keys
 43 |     ```
 44 | 
 45 | 1. Install `kubectl` on your local machine
 46 | 
 47 |    ```bash
 48 |    az aks install-cli
 49 |    ```
 50 | 
 51 | 1. Get access credentials for a managed Kubernetes cluster and save to local machine.
 52 | 
 53 |     ```bash
 54 |     az aks get-credentials -g <your-resource-group-name> -n <your-kubernetes-cluster-name>
 55 |     ```
 56 | 
 57 | 1. Get access credentials for a managed Kubernetes cluster. Note the yaml output as `kubeconfig`.
 58 | 
 59 |     ```bash
 60 |     az aks get-credentials -g <your-resource-group-name> -n <your-kubernetes-cluster-name> -f -
 61 |     ```
 62 | 
 63 | ### Create Azure Container Registry
 64 | 1. Run below command to create an Azure Container Registry.
 65 | After creation, use `login server` as Docker registry URL in the next section.
 66 | 
 67 |    ```bash
 68 |    az acr create -n <your-registry-name> -g <your-resource-group-name> --sku <sku-name> --admin-enabled true
 69 |    ```
 70 | 
 71 | 1. Run below command to show your Azure Container Registry credentials.
 72 | You will use Docker registry username and password in the next section.
 73 | 
 74 |     ```bash
 75 |     az acr credential show -n <your-registry-name>
 76 |     ```
 77 | 
 78 | ## Prepare Jenkins server
 79 | 1. Deploy a [Jenkins Master on Azure](https://aka.ms/jenkins-on-azure)
 80 | 
 81 | 1. Install the plugins in Jenkins. 
 82 | 
 83 |    Click 'Manage Jenkins' -> 'Manage Plugins' -> 'Available', then search and install the following plugins: [EnvInject](https://wiki.jenkins.io/display/JENKINS/EnvInject+Plugin), [Azure Container Agents Plugin](https://wiki.jenkins.io/display/JENKINS/Azure+Container+Service+Plugin), [Azure Container Registry Tasks Plugin](https://wiki.jenkins.io/display/JENKINS/Azure+Container+Registry+Tasks+Plugin).
 84 | 
 85 | 1. Add a Credential in type "Microsoft Azure Service Principal" with the service principal you created. Note the ID as `AZURE_CRED`.
 86 | 
 87 | 1. Add a Credential in type "Username with password" with your account of docker registry. Note the ID as `ACR_CRED`.
 88 | 
 89 | 1. Add a Credential in type "Kubernetes configuration (kubeconfig)" -> "Enter directly", with the kubeconfig you noted when creating AKS.
 90 | 
 91 | 
 92 | ## Create job
 93 | 1. Add a new job in type "Pipeline".
 94 | 
 95 | 1. Enable "Prepare an environment for the run", and put the following environment variables in "Properties Content":
 96 |     ```
 97 |     AZURE_CRED_ID=[your Azure Credential ID]
 98 |     ACR_RES_GROUP=[your ACR resource group]
 99 |     ACR_NAME=[your ACR name]
100 |     ACR_USERNAME=[your registry username]
101 |     ACR_REGISTRY=[your ACR registry url, without http schema]
102 |     ACR_CREDENTIAL_ID=[your credential id of ACR account]
103 |     ACR_SECRET=[secret name you will created in AKS to store ACR credential]
104 |     ACR_RES_GROUP=[your AKS resource group]
105 |     AKS_NAME=[your AKS name]
106 |     IMAGE_NAME=[image name you will push to ACR, without registry prefix]
107 |     DOCUMENTDB_URI=[your documentdb uri]
108 |     DOCUMENTDB_KEY=[your documentdb key]
109 |     DOCUMENTDB_DBNAME=[your documentdb databasename]
110 |     ```
111 | 
112 | 1. Choose "Pipeline script" in "Pipeline" -> "Definition".
113 | 
114 | 1. Fill the Script part with content in [Jenkinsfile-acr-with-git](../resources/jenkins/Jenkinsfile-acr-with-git)
115 | 
116 |    > In the `Jenkinsfile-acr-with-git`, it defines the pipeline step logic:
117 |    > 1. stage('build') - Send the GitHub URL to ACR to queue a build.
118 |    > 1. stage('deploy') - Apply a deployment to AKS with the new built docker image. Then expose the deployment to external.
119 | 
120 | ## Run it
121 | 1. Run jenkins job.
122 | 
123 | 1. Get the external IP address. This may take a few minutes to wait the deploy success. Before finishing, the `external-ip` field should show `pending`.
124 | 
125 |     ```bash
126 |     kubectl get svc -w
127 |     ```
128 | 
129 | 1. Open the url you obtained in last step in your browser, you will find the todo app has been deployed to your Kubernetes cluster. 
130 | 
131 | ## Clean up
132 | 
133 | Delete the Azure resources you just created by running below command:
134 | 
135 | ```bash
136 | az group delete -y --no-wait -n <your-resource-group-name>
137 | ```
138 | 


--------------------------------------------------------------------------------
/doc/deployment/deploy-to-aks-with-acr-build-local-using-jenkins.md:
--------------------------------------------------------------------------------
  1 | #  Build Docker image from local directory in Azure Container Registry then deploy to Azure Kubernetes Service using Jenkins
  2 | 
  3 | This document shows how to deploy this todo app java project to Kubernetes cluster using Jenkins. Instead of installing Docker on the build agent, you can use **Azure ACR Plugin** to build your Docker image in Azure Container Registry with your Maven packaged `jar` file.
  4 | 
  5 | On the Jenkins machine, it clones the toao-app-java-on-azure to local with **Git Plugin**, uses **Maven Plugin** to build out a `jar` file. 
  6 | Using **Azure ACR Plugin**, Jenkins uploads the `jar` together with `Dockerfile` to Azure Container Registry. ACR Quick Build will build a docker image and host it when receiving the `Dockerfile` and `jar` file. 
  7 | After ACR Quick Build finishes pushing docker image. Jenkins will use **Azure Container Agents Plugin** to apply two Kubernetes resource yaml files to Azure Kubernetes Service.
  8 | 
  9 | > This deployment instruction will include Maven package in the Dockerfile. If you want to do the Maven package on your Jenkins Server instead during the docker build, please go to [Build Docker image from git repo in Azure Container Registry then deploy to Azure Kubernetes Service using Jenkins](./deploy-to-aks-with-acr-build-git-using-jenkins.md).
 10 | 
 11 | ## Run application on local machine
 12 | Verify you can run your project successfully in your local environment. ([Run project on local machine](../../README.md))
 13 | 
 14 | ## Create Azure services
 15 | 
 16 | You can create the Azure Services using [Azure CLI 2.0](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest).
 17 | 
 18 | 1. login your Azure CLI, and set your subscription id 
 19 |     
 20 |     ```bash
 21 |     az login
 22 |     az account set -s <your-subscription-id>
 23 |     ```
 24 | 
 25 | 1. Create a resource group
 26 | 
 27 |     ```bash
 28 |     az group create -n <your-resource-group-name> -l eastus
 29 |     ```
 30 | 
 31 | ### Create Azure Service Principal
 32 | 
 33 | 1. Create a service principal  and configure its access to all Azure resources under this subscription. Note all the information as service principal.
 34 | 
 35 |    ```bash
 36 |    az ad sp create-for-rbac
 37 |    ```
 38 |     
 39 | ### Create Azure Kubernetes Service
 40 | 
 41 | 1. Create Kubernetes cluster
 42 | 
 43 |     ```bash
 44 |     az aks create -g <your-resource-group-name> -n <your-kubernetes-cluster-name> --generate-ssh-keys
 45 |     ```
 46 | 
 47 | 1. Install `kubectl` on your local machine
 48 | 
 49 |    ```bash
 50 |    az aks install-cli
 51 |    ```
 52 | 
 53 | 1. Get access credentials for a managed Kubernetes cluster and save to local machine.
 54 | 
 55 |     ```bash
 56 |     az aks get-credentials -g <your-resource-group-name> -n <your-kubernetes-cluster-name>
 57 |     ```
 58 | 
 59 | 1. Get access credentials for a managed Kubernetes cluster. Note the yaml output as `kubeconfig`.
 60 | 
 61 |     ```bash
 62 |     az aks get-credentials -g <your-resource-group-name> -n <your-kubernetes-cluster-name> -f -
 63 |     ```
 64 | 
 65 | ### Create Azure Container Registry
 66 | 1. Run below command to create an Azure Container Registry.
 67 | After creation, use `login server` as Docker registry URL in the next section.
 68 | 
 69 |    ```bash
 70 |    az acr create -n <your-registry-name> -g <your-resource-group-name> --sku <sku-name> --admin-enabled true
 71 |    ```
 72 | 
 73 | 1. Run below command to show your Azure Container Registry credentials.
 74 | You will use Docker registry username and password in the next section.
 75 | 
 76 |     ```bash
 77 |     az acr credential show -n <your-registry-name>
 78 |     ```
 79 | 
 80 | ## Prepare Jenkins server
 81 | 1. Deploy a [Jenkins Master on Azure](https://aka.ms/jenkins-on-azure).
 82 | 
 83 | 1. Connect to the server with SSH and install the build tools:
 84 |    
 85 |    ```
 86 |    sudo apt-get install git maven
 87 |    ```
 88 | 
 89 | 1. Install the plugins in Jenkins. 
 90 | 
 91 |    Click 'Manage Jenkins' -> 'Manage Plugins' -> 'Available', then search and install the following plugins: [EnvInject](https://wiki.jenkins.io/display/JENKINS/EnvInject+Plugin), [Azure Container Agents Plugin](https://wiki.jenkins.io/display/JENKINS/Azure+Container+Service+Plugin), [Azure Container Registry Tasks Plugin](https://wiki.jenkins.io/display/JENKINS/Azure+Container+Registry+Tasks+Plugin).
 92 | 
 93 | 1. Add a Credential in type "Microsoft Azure Service Principal" with the service principal you created. Note the ID as `AZURE_CRED`.
 94 | 
 95 | 1. Add a Credential in type "Username with password" with your account of docker registry. Note the ID as `ACR_CRED`.
 96 | 
 97 | 1. Add a Credential in type "Kubernetes configuration (kubeconfig)" -> "Enter directly", with the kubeconfig you noted when creating AKS.
 98 | 
 99 | 
100 | ## Create job
101 | 1. Add a new job in type "Pipeline".
102 | 
103 | 1. Enable "Prepare an environment for the run", and put the following environment variables in "Properties Content":
104 |     ```
105 |     AZURE_CRED_ID=[your Azure Credential ID]
106 |     ACR_RES_GROUP=[your ACR resource group]
107 |     ACR_NAME=[your ACR name]
108 |     ACR_USERNAME=[your registry username]
109 |     ACR_REGISTRY=[your ACR registry url, without http schema]
110 |     ACR_CREDENTIAL_ID=[your credential id of ACR account]
111 |     ACR_SECRET=[secret name you will created in AKS to store ACR credential]
112 |     AKS_RES_GROUP=[your AKS resource group]
113 |     AKS_NAME=[your AKS name]
114 |     IMAGE_NAME=[image name you will push to ACR, without registry prefix]
115 |     DOCUMENTDB_URI=[your documentdb uri]
116 |     DOCUMENTDB_KEY=[your documentdb key]
117 |     DOCUMENTDB_DBNAME=[your documentdb databasename]
118 |     ```
119 | 
120 | 1. Choose "Pipeline script from SCM" in "Pipeline" -> "Definition".
121 | 
122 | 1. Fill in the SCM repo url, branch and script path.
123 | 
124 |    For this example, you should put:   
125 |    * `https://github.com/Microsoft/todo-app-java-on-azure` as "Repository URL"
126 |    * `*/master` as "Branches to build"
127 |    * `doc/resources/jenkins/Jenkinsfile-acr` as "Script Path"
128 | 
129 |    > In the `Jenkinsfile-acr`, it defines the pipeline step logic:
130 |    > 1. stage('init') - Checkout to the scm
131 |    > 1. stage('build') - Use `Maven` to build out a jar file. Upload the jar and `Dockerfile` to ACR to build the docker image.
132 |    > 1. stage('deploy') - Apply a deployment to AKS with the new built docker image. Then expose the deployment to external.
133 | 
134 | ## Run it
135 | 1. Run jenkins job.
136 | 
137 | 1. Get the external IP address. This may take a few minutes to wait the deploy success. Before finishing, the `external-ip` field should show `pending`.
138 | 
139 |     ```bash
140 |     kubectl get svc -w
141 |     ```
142 | 
143 | 1. Open the url you obtained in last step in your browser, you will find the todo app has been deployed to your Kubernetes cluster. 
144 | 
145 | ## Clean up
146 | 
147 | Delete the Azure resources you just created by running below command:
148 | 
149 | ```bash
150 | az group delete -y --no-wait -n <your-resource-group-name>
151 | ```
152 | 


--------------------------------------------------------------------------------
/doc/deployment/deploy-to-azure-container-service-using-jenkins.md:
--------------------------------------------------------------------------------
  1 | # Deploy to Azure Container Service using Jenkins
  2 | 
  3 | This document shows how to deploy this todo app java project to Kubernetes cluster using Jenkins.
  4 | 
  5 | ## Create Azure services
  6 | 
  7 | You can create the Azure Services using [Azure CLI 2.0](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest).
  8 | 
  9 | ### Create Azure Container Service
 10 | 
 11 | 1. login your Azure CLI, and set your subscription id 
 12 |     
 13 |     ```bash
 14 |     az login
 15 |     az account set -s <your-subscription-id>
 16 |     ```
 17 | 
 18 | 1. Create a resource group
 19 | 
 20 |     ```bash
 21 |     az group create -n <your-resource-group-name> -l westeurope
 22 |     ```
 23 | 
 24 | 1. Create Kubernetes cluster
 25 | 
 26 |     ```bash
 27 |     az acs create --orchestrator-type kubernetes -g <your-resource-group-name> -n <your-kubernetes-cluster-name> --generate-ssh-keys
 28 |     ```
 29 | 
 30 | 1. Connect to the cluster, this command download the Kubernetes configuration to your profile folder. The kubectl will use this configure file to interact with your Kubernetes cluster.
 31 | 
 32 |     ```bash
 33 |     az acs kubernetes get-credentials -g <your-resource-group-name> -n <your-kubernetes-cluster-name>
 34 |     ```
 35 | 
 36 | 1. Install the kubectl command line
 37 | 
 38 |     ```bash
 39 |     az acs kubernetes install-cli
 40 |     ```
 41 | 
 42 | ### Create Azure Container Registry
 43 | 
 44 | 1. login your Azure CLI, and set your subscription id 
 45 |    
 46 |     ```bash
 47 |     az login
 48 |     az account set -s <your-subscription-id>
 49 |     ```
 50 | 
 51 | 1. Run below command to create an Azure Container Registry.
 52 | After creation, use `login server` as Docker registry URL in the next section.
 53 | 
 54 |    ```bash
 55 |    az acr create -n <your-registry-name> -g <your-resource-group-name> --sku <sku-name> --admin-enabled true
 56 |    ```
 57 | 
 58 | 1. Run below command to show your Azure Container Registry credentials.
 59 | You will use Docker registry username and password in the next section.
 60 | 
 61 |     ```bash
 62 |     az acr credential show -n <your-registry-name>
 63 |     ```
 64 | 
 65 | ## Prepare Jenkins server
 66 | 1. Deploy a Jenkins Master on Azure[https://aka.ms/jenkins-on-azure]
 67 | 
 68 | 1. Connect to the server with SSH and install the build tools:
 69 |    
 70 |    ```
 71 |    sudo apt-get install git maven docker.io
 72 |    ```
 73 | 
 74 | 1. Install the plugins in Jenkins. Click 'Manage Jenkins' -> 'Manage Plugins' -> 'Available', 
 75 | then search and install the following plugins: EnvInject, Azure Kubernetes CD Plugin.
 76 | 
 77 | 1. Add a Credential in type "SSH Username with private key" with your Kubernetes login
 78 |    credential.
 79 | 
 80 | 1. Add a Credential in type "Username with password" with your account of docker registry.
 81 | 
 82 | ## Create job
 83 | 1. Add a new job in type "Pipeline".
 84 | 
 85 | 1. Enable "Prepare an environment for the run", and put the following environment variables in "Properties Content":
 86 |     ```
 87 |     ACS_SERVER=[your Azure Container Service server]
 88 |     ACS_CRED_ID=[your credential id of ACS login credential]
 89 |     ACR_SERVER=[your Azure Container Registry]
 90 |     ACR_CRED_ID=[your credential id of ACR account]
 91 |     WEB_APP=[the name of the app]
 92 |     DOCUMENTDB_URI=[your documentdb uri]
 93 |     DOCUMENTDB_KEY=[your documentdb key]
 94 |     DOCUMENTDB_DBNAME=[your documentdb databasename]
 95 |     ```
 96 | 
 97 | 1. Choose "Pipeline script from SCM" in "Pipeline" -> "Definition".
 98 | 
 99 | 1. Fill in the SCM repo url and script path.
100 | 
101 | 1. Create Kubernetes resource yaml file fragments. 
102 | 
103 |     * Create `src/main/jenkins/jenkins-sample.yml` with yaml content from [this file](../resources/jenkins/jenkins-sample.yml). This file defines a deployment and a service with the docker image you pushed to your Azure Container Registry.
104 | 
105 | 
106 | ## Run it
107 | 1. Verify you can run your project successfully in your local environment. ([Run project on local machine](../../README.md))
108 | 
109 | 1. Run jenkins job.
110 | 
111 | 1. Get the external IP address. This may take a few minutes to wait the deploy success. Before finishing, the `external-ip` field should show `pending`.
112 | 
113 |     ```bash
114 |     kubectl get svc -w
115 |     ```
116 | 
117 | 1. Open the url you obtained in last step in your browser, you will find the todo app has been deployed to your Kubernetes cluster. 
118 | 
119 | ## Clean up
120 | 
121 | Delete the Azure resources you just created by running below command:
122 | 
123 | ```bash
124 | az group delete -y --no-wait -n <your-resource-group-name>
125 | ```
126 | 


--------------------------------------------------------------------------------
/doc/deployment/deploy-to-azure-container-service-using-maven-plugin.md:
--------------------------------------------------------------------------------
  1 | # Deploy to Azure Container Service (AKS) using Fabric8 Maven Plugin
  2 | 
  3 | This document shows how to deploy this todo app java project to Kubernetes cluster using Maven plugin.
  4 | It firstly uses Spotify Docker Maven Plugin to build a docker image and push the image to a private Azure Container Registry.
  5 | Then, it uses Fabric8 Maven Plugin to generate Kubernetes resource yaml file and apply the yaml file to your cluster.
  6 | 
  7 | ## Create Azure services
  8 | 
  9 | You can create the Azure Services using [Azure CLI 2.0](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest).
 10 | 
 11 | ### Create Azure Container Service (AKS)
 12 | 
 13 | 1. login your Azure CLI, and set your subscription id 
 14 |     
 15 |     ```bash
 16 |     az login
 17 |     az account set -s <your-subscription-id>
 18 |     ```
 19 | 
 20 | 1. Create a resource group
 21 | 
 22 |     ```bash
 23 |     az group create -n <your-resource-group-name> -l westeurope
 24 |     ```
 25 | 
 26 | 1. Create Kubernetes cluster in Azure Container Service (AKS)
 27 | 
 28 |     ```bash
 29 |     az aks create -g <your-resource-group-name> -n <your-kubernetes-cluster-name> --generate-ssh-keys
 30 |     ```
 31 | 
 32 | 1. Connect to the cluster, this command download the Kubernetes configuration to your profile folder. The Fabric8 Maven Plugin and kubectl will use this configure file to interact with your Kubernetes cluster.
 33 | 
 34 |     ```bash
 35 |     az aks get-credentials -g <your-resource-group-name> -n <your-kubernetes-cluster-name>
 36 |     ```
 37 | 
 38 | 1. Install the kubectl command line
 39 | 
 40 |     ```bash
 41 |     az acs kubernetes install-cli
 42 |     ```
 43 | 
 44 | ### Create Azure Container Registry
 45 | 
 46 | 1. Run below command to create an Azure Container Registry.
 47 | After creation, use `login server` as Docker registry URL in the next section.
 48 | 
 49 |    ```bash
 50 |    az acr create -n <your-registry-name> -g <your-resource-group-name> --sku <sku-name>
 51 |    ```
 52 |        where `<sku-name>` is one of the following: `{Basic,Managed_Basic,Managed_Standard,Managed_Premium}`.
 53 | 
 54 | 1. Run below command to show your Azure Container Registry credentials.
 55 | You will use Docker registry username and password in the next section.
 56 | 
 57 |     ```bash
 58 |     az acr credential show -n <your-registry-name>
 59 |     ```
 60 | 
 61 | ## Configuration
 62 | 
 63 | 1. In the Maven settings file `~/.m2/settings.xml`, add a new `<server>` element with your container registry credentials from previous steps.
 64 | 
 65 |     ```xml
 66 |     <server>
 67 |       <id>put-your-docker-registry-url</id>
 68 |       <username>put-your-docker-username</username>
 69 |       <password>put-your-docker-key</password>
 70 |       <configuration>
 71 |         <email>put-your-email</email>
 72 |       </configuration>
 73 |     </server>
 74 |     ```
 75 | 
 76 | 1. In `<properties>` section of the project's `pom.xml`, replace value in `<docker.image.prefix>` element with your docker registry URL.
 77 | 
 78 |     ```xml
 79 |     <docker.image.prefix>put-your-docker-registry-url</docker.image.prefix>
 80 |     ```
 81 | 
 82 | 1. Create Kubernetes resource yaml file fragments. 
 83 | 
 84 |     The Fabric8 Maven Plugin supports putting Kubernetes yaml files in the `src/main/fabric8` folder. And this plugin will aggregate these yaml file into one Kubernetes resource list file, which can be apply to cluster directly.
 85 | 
 86 |     * Copy [fabric8/deployment.yml](../resources/fabric8/deployment.yml) to `src/main/fabric8/deployment.yml`. This file defines a deployment with the docker image you pushed to your Azure Container Registry.
 87 | 
 88 |     * Copy [fabric8/service.yml](../resources/fabric8/service.yml) to `src/main/fabric8/service.yml`. This file defines a service to expose the deployment to external internet.
 89 | 
 90 |     * Copy [fabric8/secrets.yml](../resources/fabric8/secrets.yml) to `src/main/fabric8/secrets.yml`. This file defines a docker-registry secrets, which will be used to pull image from your Azure Container Registry.
 91 | 
 92 | 
 93 | ## Run it
 94 | 1. Verify you can run your project successfully in your local environment. ([Run project on local machine](../../README.md))
 95 | 
 96 | 1. Build the project package
 97 | 
 98 |     ```bash
 99 |     mvn clean package
100 |     ```
101 | 
102 | 1. Build the docker image and push it to your Azure Container Registry.
103 | 
104 |     ```bash
105 |     mvn docker:build docker:push
106 |     ```
107 | 
108 | 1. Deploy image to your Kubernetes cluster.
109 | 
110 |     ```bash
111 |     mvn fabric8:resource fabric8:apply
112 |     ```
113 | 
114 |     > NOTE: You can also run above commands as a one-liner:  
115 |     > `mvn clean package docker:build docker:push fabric8:resource fabric8:apply`
116 | 
117 | 1. Get the external IP address. This may take a few minutes to wait the deploy success. Before finishing, the `external-ip` field should show `pending`.
118 | 
119 |     ```bash
120 |     kubectl get svc -w
121 |     ```
122 | 
123 | 1. Open the url you obtained in last step in your browser, you will find the todo app has been deployed to your Kubernetes cluster. 
124 | 
125 | ## Clean up
126 | 
127 | Delete the Azure resources you just created by running below command:
128 | 
129 | ```bash
130 | az group delete -y --no-wait -n <your-resource-group-name>
131 | ```
132 | 


--------------------------------------------------------------------------------
/doc/deployment/deploy-to-azure-web-app-javase-using-jenkins.md:
--------------------------------------------------------------------------------
 1 | # Deploy to Azure Web App for Java SE applictions using Jenkins
 2 | 
 3 | This tutorial shows you how to deploy a Java SE app to Azure Web App using [Azure App Service Plugin](https://wiki.jenkins.io/display/JENKINS/Azure+App+Service+Plugin).
 4 | Below are the major steps in this tutorial.
 5 | - [Create Azure Web App](#create-app)
 6 | - [Prepare Jenkins server](#prepare)
 7 | - [Create job](#create-job)
 8 | - [Build and Deploy Java SE Application to Azure Web App](#deploy)
 9 | - [Clean Up Resources](#clean-up)
10 | 
11 | ## <a name="create-app"></a>Create Azure Web App
12 | 
13 | Create an Azure Web App with Java as a rumtime stack by [Azure portal](https://azure.microsoft.com/en-us/blog/public-preview-of-java-on-app-service-built-in-support-for-tomcat-and-openjdk) or [Azure CLI](https://docs.microsoft.com/en-us/azure/app-service/app-service-cli-samples?toc=%2fazure%2fapp-service%2fcontainers%2ftoc.json)
14 | 
15 | > If you use Web App on Linux with jre runtime stack, you have to build your app with port 80 or set the web app setting with `PORT=8080`
16 | 
17 | ## <a name="prepare"></a>Prepare Jenkins server
18 | 
19 | 1. Deploy a [Jenkins Master](https://aka.ms/jenkins-on-azure) on Azure
20 | 
21 | 1. Install maven and zip commands for your Jenkins Master.
22 | 
23 | 1. Install the plugins in Jenkins. Click 'Manage Jenkins' -> 'Manage Plugins' -> 'Available', 
24 | then search and install the following plugins: Azure App Service Plugin, EnvInject Plugin.
25 | 
26 | 1. Add a Credential in type "Microsoft Azure Service Principal" with your service principal.
27 | 
28 | ## <a name="create-job"></a>Create job
29 | 
30 | 1. Add a new job in type "Pipeline".
31 | 
32 | 1. Enable "Prepare an environment for the run", and put the following environment variables
33 |    in "Properties Content":
34 |     ```
35 |     AZURE_CRED_ID=[your credential id of service principal]
36 |     RES_GROUP=[your resource group of the web app]
37 |     WEB_APP=[the name of the web app]
38 |     DOCUMENTDB_URI=[the URI of the DocumentDB]
39 |     DOCUMENTDB_KEY=[the key of the DocumentDB]
40 |     DOCUMENTDB_DBNAME=[the name of the DocumentDB]
41 |     ```
42 |     
43 |     > You can save your DocumentDB settings in your Web App Application settings if you would like to manage your application settings independently.
44 | 
45 | 1. Copy [jenkins/web.config](../resources/jenkins/web.config) to `src/main/resources/web.config` and replace the `${JAR_FILE_NAME}` with your app's jar file name.
46 |    
47 | 1. Choose "Pipeline script from SCM" in "Pipeline" -> "Definition".
48 | 
49 | 1. Fill in the SCM repo url and script path. ([Script Example](../resources/jenkins/Jenkinsfile-webapp-se))
50 | 
51 | 1. Archive your jar file and web.config in zip format manually or in command like the example script above.
52 | 
53 | 
54 | ## <a name="deploy"></a>Build and Deploy Java SE application to Azure Web App
55 | 
56 | 1. Verify you can run your project successfully in your local environment. ([Run project on local machine](../../README.md))
57 | 
58 | 1. Run jenkins job.
59 | 
60 | 1. Navigate to the website from your favorite browser.
61 | You will see this app successfully running on Azure Web App.
62 | 
63 | ## <a name="clean-up"></a>Clean Up Resources
64 | 
65 | Delete the Azure resources you just created by running below command:
66 | 
67 | ```bash
68 | az group delete -y --no-wait -n <your-resource-group-name>
69 | ```
70 | 


--------------------------------------------------------------------------------
/doc/deployment/deploy-to-azure-web-app-tomcat-using-jenkins.md:
--------------------------------------------------------------------------------
 1 | # Deploy to Azure Web App for Tomcat using Jenkins
 2 | 
 3 | This tutorial shows you how to deploy a Java app to Azure Web App for Tomcat using [Azure App Service Plugin](https://wiki.jenkins.io/display/JENKINS/Azure+App+Service+Plugin).
 4 | Below are the major steps in this tutorial.
 5 | - [Create Azure Web App](#create-app)
 6 | - [Prepare Jenkins server](#prepare)
 7 | - [Create job](#create-job)
 8 | - [Build and Deploy Java Application to Azure Web App](#deploy)
 9 | - [Clean Up Resources](#clean-up)
10 | 
11 | ## <a name="create-app"></a>Create Azure Web App
12 | 
13 | Create an Azure Web App with built-in support for Tomcat by [Azure portal](https://azure.microsoft.com/en-us/blog/public-preview-of-java-on-app-service-built-in-support-for-tomcat-and-openjdk) or [Azure CLI](https://docs.microsoft.com/en-us/azure/app-service/app-service-cli-samples?toc=%2fazure%2fapp-service%2fcontainers%2ftoc.json).
14 | 
15 | ## <a name="prepare"></a>Prepare Jenkins server
16 | 
17 | 1. Deploy a [Jenkins Master](https://aka.ms/jenkins-on-azure) on Azure
18 | 
19 | 1. Install the plugins in Jenkins. Click 'Manage Jenkins' -> 'Manage Plugins' -> 'Available', 
20 | then search and install the following plugins: Azure App Service Plugin, EnvInject Plugin.
21 | 
22 | 1. Add a Credential in type "Microsoft Azure Service Principal" with your service principal.
23 | 
24 | ## <a name="create-job"></a>Create job
25 | 
26 | 1. Add a new job in type "Pipeline".
27 | 
28 | 1. Enable "Prepare an environment for the run", and put the following environment variables
29 |    in "Properties Content":
30 |     ```
31 |     AZURE_CRED_ID=[your credential id of service principal]
32 |     RES_GROUP=[your resource group of the web app]
33 |     WEB_APP=[the name of the web app]
34 |     DOCUMENTDB_URI=[the URI of the DocumentDB]
35 |     DOCUMENTDB_KEY=[the key of the DocumentDB]
36 |     DOCUMENTDB_DBNAME=[the name of the DocumentDB]
37 |     ```
38 | 
39 |     > You can save your DocumentDB settings in your Web App Application settings if you would like to manage your application settings independently.
40 | 
41 | 1. This application's default package type is jar. So you have to make some changes to enable it create a deployable war file. Please refer to Spring Boot doc [here](https://docs.spring.io/spring-boot/docs/current/reference/htmlsingle/#howto-create-a-deployable-war-file).
42 | 
43 | 1. Choose "Pipeline script from SCM" in "Pipeline" -> "Definition".
44 | 
45 | 1. Fill in the SCM repo url and script path. ([Script Example](../resources/jenkins/Jenkinsfile-webapp-tomcat))
46 | 
47 | 
48 | ## <a name="deploy"></a>Build and Deploy Java application to Azure Web App
49 | 
50 | 1. Verify you can run your project successfully in your local environment. ([Run project on local machine](../../README.md))
51 | 
52 | 1. Run jenkins job.
53 | 
54 | 1. Navigate to the website from your favorite browser.
55 | You will see this app successfully running on Azure Web App.
56 | 
57 | 
58 | ## <a name="clean-up"></a>Clean Up Resources
59 | 
60 | Delete the Azure resources you just created by running below command:
61 | 
62 | ```bash
63 | az group delete -y --no-wait -n <your-resource-group-name>
64 | ```
65 | 


--------------------------------------------------------------------------------
/doc/deployment/deploy-to-azure-web-app-using-eclipse-plugin.md:
--------------------------------------------------------------------------------
 1 | # Deploy to Azure Web App for Containers using Eclipse Plugin
 2 | 
 3 | This tutorial shows you how to deploy this containerized app to Azure Web App for Containers using [Azure Toolkit for Eclipse](https://github.com/Microsoft/azure-tools-for-java).
 4 | Below are the major steps in this tutorial.
 5 | - [Create Azure Container Registry](#create-acr)
 6 | - [Deploy to Azure Web App for Containers using Eclipse Plugin](#deploy)
 7 | 
 8 | <a name="create-acr"></a>
 9 | ## Create Azure Container Registry
10 | 
11 | 1. login your Azure CLI, and set your subscription id 
12 |     
13 |     ```bash
14 |     az login
15 |     az account set -s <your-subscription-id>
16 |     ```
17 | 
18 | 1. Run below command to create an Azure Container Registry.
19 | After creation, use `login server` as Container Registry URL in the next section.
20 | 
21 |    ```bash
22 |    az acr create -n <your-registry-name> -g <your-resource-group-name> --sku <sku-name>
23 |    ```
24 |         where `<sku-name>` is one of the following: `{Basic,Managed_Basic,Managed_Standard,Managed_Premium}`.
25 | 
26 | 1. Run below command to show your Azure Container Registry credentials.
27 | You will use Docker registry username and password in the next section.
28 | 
29 |     ```bash
30 |     az acr credential show -n <your-registry-name>
31 |     ```
32 | 
33 | <a name="deploy"></a>
34 | ## Deploy to Azure Web App for Containers using Eclipse Plugin
35 | 1. Create or import a Maven project in Eclipse. 
36 | 
37 | 1. Right-click on the project and choose "Azure -> Add Docker Support". It will automatically generate a Dockerfile. 
38 | 
39 | 1. Right-click on the project and choose "Azure -> Run on Web App on Linux".  
40 | 
41 | 1. Provide Azure Container Registry and Web App for Containers configuration info, and hit run.
42 | 
43 | You will see this app successfully running on Azure Web App for Containers.
44 | 
45 | 


--------------------------------------------------------------------------------
/doc/deployment/deploy-to-azure-web-app-using-intelliJ-plugin.md:
--------------------------------------------------------------------------------
 1 | # Deploy to Azure Web App for Containers using IntelliJ Plugin
 2 | 
 3 | This tutorial shows you how to deploy this containerized app to Azure Web App for Containers using [Azure Toolkit for IntelliJ](https://github.com/Microsoft/azure-tools-for-java).
 4 | Below are the major steps in this tutorial.
 5 | - [Create Azure Container Registry](#create-acr)
 6 | - [Deploy to Azure Web App for Containers using IntelliJ Plugin](#deploy)
 7 | 
 8 | <a name="create-acr"></a>
 9 | ## Create Azure Container Registry
10 | 
11 | 1. login your Azure CLI, and set your subscription id 
12 |     
13 |    ```bash
14 |    az login
15 |    az account set -s <your-subscription-id>
16 |    ```
17 | 
18 | 1. Run below command to create an Azure Container Registry.
19 | After creation, use `login server` as Container Registry URL in the next section.
20 | 
21 |    ```bash
22 |    az acr create -n <your-registry-name> -g <your-resource-group-name> --sku <sku-name>
23 |    ```
24 |     where `<sku-name>` is one of the following: `{Basic,Managed_Basic,Managed_Standard,Managed_Premium}`.
25 |     
26 | 1. Run below command to show your Azure Container Registry credentials.
27 | You will use Docker registry username and password in the next section.
28 | 
29 |     ```bash
30 |     az acr credential show -n <your-registry-name>
31 |     ```
32 | You may be prompted to run `az acr update -n <your-registry-name> --admin-enabled true` to enable admin first.
33 | 
34 | <a name="deploy"></a>
35 | ## Deploy to Azure Web App for Containers using IntelliJ Plugin
36 | 1. Create or import a Maven project in IntelliJ IDEA. 
37 | 
38 | 1. If you don't already have a Dockerfile, right-click on the project and choose "Azure -> Add Docker Support" to automatically generate one. 
39 | 
40 | 1. Right-click on the project and choose "Azure -> Run on Web App on Linux".  
41 | 
42 | 1. Provide Azure Container Registry and Web App for Containers configuration info, and hit run.
43 | 
44 | You will see this app successfully running on Azure Web App for Containers.
45 | 
46 | 


--------------------------------------------------------------------------------
/doc/deployment/deploy-to-azure-web-app-using-jenkins.md:
--------------------------------------------------------------------------------
 1 | # Deploy to Azure Web App for Containers using Jenkins
 2 | 
 3 | This tutorial shows you how to deploy this containerized app to Azure Web App for Containers using [Azure App Service Plugin](https://wiki.jenkins.io/display/JENKINS/Azure+App+Service+Plugin).
 4 | Below are the major steps in this tutorial.
 5 | - [Create Azure Container Registry](#create-acr)
 6 | - [Prepare Jenkins server](#prepare)
 7 | - [Create job](#create-job)
 8 | - [Build and Deploy Docker Container Image to Azure Web App for Containers](#deploy)
 9 | - [Clean Up Resources](#clean-up)
10 | 
11 | ## <a name="create-acr"></a>Create Azure Container Registry
12 | 
13 | 1. login your Azure CLI, and set your subscription id 
14 |    
15 |     ```bash
16 |     az login
17 |     az account set -s <your-subscription-id>
18 |     ```
19 | 
20 | 1. Run below command to create an Azure Container Registry.
21 | After creation, use `login server` as Container Registry URL in the next section.
22 | 
23 |    ```bash
24 |    az acr create -n <your-registry-name> -g <your-resource-group-name> --sku <sku-name> --admin-enabled true
25 |    ```
26 | 
27 | 1. Run below command to show your Azure Container Registry credentials.
28 | You will use Docker registry username and password in the next section.
29 | 
30 |     ```bash
31 |     az acr credential show -n <your-registry-name>
32 |     ```
33 | 
34 | ## <a name="prepare"></a>Prepare Jenkins server
35 | 
36 | 1. Deploy a [Jenkins Master](https://aka.ms/jenkins-on-azure) on Azure
37 | 
38 | 1. Connect to the server with SSH and install the build tools:
39 |    ```
40 |    sudo apt-get install git maven docker.io
41 |    ```
42 | 
43 | 1. Install the plugins in Jenkins. Click 'Manage Jenkins' -> 'Manage Plugins' -> 'Available', 
44 | then search and install the following plugins: EnvInject, Azure App Service Plugin.
45 | 
46 | 1. Add a Credential in type "Microsoft Azure Service Principal" with your service principal.
47 | 
48 | 1. Add a Credential in type "Username with password" with your account of docker registry.
49 | 
50 | ## <a name="create-job"></a>Create job
51 | 
52 | 1. Add a new job in type "Pipeline".
53 | 
54 | 1. Enable "Prepare an environment for the run", and put the following environment variables
55 |    in "Properties Content":
56 |     ```
57 |     AZURE_CRED_ID=[your credential id of service principal]
58 |     RES_GROUP=[your resource group of the web app]
59 |     WEB_APP=[the name of the web app]
60 |     ACR_SERVER=[your address of azure container registry]
61 |     ACR_CRED_ID=[your credential id of ACR account]
62 |     DOCUMENTDB_URI=[your documentdb uri]
63 |     DOCUMENTDB_KEY=[your documentdb key]
64 |     DOCUMENTDB_DBNAME=[your documentdb databasename]
65 |     ```
66 | 
67 | 1. Choose "Pipeline script from SCM" in "Pipeline" -> "Definition".
68 | 
69 | 1. Fill in the SCM repo url and script path.
70 | 
71 | 
72 | ## <a name="deploy"></a>Build and Deploy Docker Container Image to Azure Web App for Containers
73 | 
74 | 1. Verify you can run your project successfully in your local environment. ([Run project on local machine](../../README.md))
75 | 
76 | 1. Run jenkins job.
77 | 
78 | 1. Navigate to the website from your favorite browser.
79 | You will see this app successfully running on Azure Web App for Containers.
80 | 
81 | 
82 | ## <a name="clean-up"></a>Clean Up Resources
83 | 
84 | Delete the Azure resources you just created by running below command:
85 | 
86 | ```bash
87 | az group delete -y --no-wait -n <your-resource-group-name>
88 | ```
89 | 


--------------------------------------------------------------------------------
/doc/deployment/deploy-to-azure-web-app-using-maven-plugin.md:
--------------------------------------------------------------------------------
 1 | # Deploy to Azure Web App for Containers using Maven Plugin
 2 | 
 3 | This tutorial shows you how to deploy this containerized app to Azure Web App for Containers using [Maven Plugin for Azure Web Apps](https://github.com/Microsoft/azure-maven-plugins/tree/master/azure-webapp-maven-plugin).
 4 | Below are the major steps in this tutorial.
 5 | - [Create Azure Container Registry](#create-acr)
 6 | - [Setup and Customize Configuration](#config)
 7 | - [Build and Deploy Docker Container Image to Azure Web App for Containers](#deploy)
 8 | - [Clean Up Resources](#clean-up)
 9 | 
10 | <a name="create-acr"></a>
11 | ## Create Azure Container Registry
12 | 
13 | 1. login your Azure CLI, and set your subscription id 
14 |     
15 |    ```bash
16 |    az login
17 |    az account set -s <your-subscription-id>
18 |    ```
19 | 
20 | 1. Run below command to create an Azure Container Registry.
21 | After creation, use `login server` as Container Registry URL in the next section.
22 | 
23 |    ```bash
24 |    az acr create -n <your-registry-name> -g <your-resource-group-name> --sku <sku-name>
25 |    ```
26 |        where `<sku-name>` is one of the following: `{Basic,Managed_Basic,Managed_Standard,Managed_Premium}`.
27 | 
28 | 1. Run below command to show your Azure Container Registry credentials.
29 | You will use Docker registry username and password in the next section.
30 | 
31 |     ```bash
32 |     az acr credential show -n <your-registry-name>
33 |     ```
34 | 
35 | <a name="config"></a>
36 | ## Setup and Customize Configuration
37 | 
38 | 1. In the Maven settings file `~/.m2/settings.xml`, add a new `<server>` element with your Azure Container Registry credentials from previous steps.
39 | 
40 |     ```xml
41 |     <server>
42 |       <id>put-your-docker-registry-url</id>
43 |       <username>put-your-docker-username</username>
44 |       <password>put-your-docker-key</password>
45 |       <configuration>
46 |         <email>put-your-email</email>
47 |       </configuration>
48 |     </server>
49 |     ```
50 | 
51 | 1. In `<properties>` section of the project's `pom.xml`, replace value in `<docker.image.prefix>` element with your Azure Container Registry URL.
52 | 
53 |     ```xml
54 |     <docker.image.prefix>put-your-docker-registry-url</docker.image.prefix>
55 |     ```
56 | 
57 | 1. Optional. In `<properties>` section of the project's `pom.xml`, modify value in `<azure.app.name>` element with any unique string as your app name.
58 | 
59 |    Default value is `todo-app-${maven.build.timestamp}`. The `${maven.build.timestamp}` part is used to avoid conflict in Azure and will be different in each build. 
60 | 
61 | <a name="deploy"></a>
62 | ## Build and Deploy Docker Container Image to Azure Web App for Containers
63 | 1. Verify you can run your project successfully in your local environment. ([Run project on local machine](../../README.md))
64 | 
65 | 1. Build project and docker container image, and push the image to your Azure Container Registry.
66 | 
67 |     ```bash
68 |     mvn clean package docker:build docker:push
69 |     ```
70 | 
71 | 1. Deploy Docker container image from your Azure Container Registry to Azure Web App for Containers.
72 | 
73 |     ```bash
74 |     mvn azure-webapp:deploy
75 |     ```
76 | 
77 |     > NOTE: You can also run above commands as a one-liner:  
78 |     > `mvn clean package docker:build docker:push azure-webapp:deploy`
79 | 
80 | 1. Navigate to the website from your favorite browser.
81 | You will see this app successfully running on Azure Web App for Containers.
82 | 
83 | <a name="clean-up"></a>
84 | ## Clean Up Resources
85 | 
86 | Delete the Azure resources you just created by running below command:
87 | 
88 | ```bash
89 | az group delete -y --no-wait -n <your-resource-group-name>
90 | ```
91 | 


--------------------------------------------------------------------------------
/doc/deployment/images/publicip.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/microsoft/todo-app-java-on-azure/0544030ef592a09018fbb663d8ec59f682cdd2fc/doc/deployment/images/publicip.png


--------------------------------------------------------------------------------
/doc/resources/fabric8/deployment.yml:
--------------------------------------------------------------------------------
 1 | apiVersion: extensions/v1beta1
 2 | kind: Deployment
 3 | metadata:
 4 |   name: ${project.artifactId}
 5 |   labels:
 6 |     run: spring
 7 | spec:
 8 |   replicas: 1
 9 |   selector:
10 |     matchLabels:
11 |       run: spring
12 |   strategy:
13 |     rollingUpdate:
14 |       maxSurge: 1
15 |       maxUnavailable: 1
16 |     type: RollingUpdate
17 |   template:
18 |     metadata:
19 |       labels:
20 |         run: spring
21 |     spec:
22 |       containers:
23 |       - image: ${docker.image.prefix}/${project.artifactId}:${project.version}
24 |         name: spring
25 |         ports:
26 |         - containerPort: 8080
27 |       imagePullPolicy: Always
28 |       imagePullSecrets:
29 |         - name: mydockerkey


--------------------------------------------------------------------------------
/doc/resources/fabric8/secrets.yml:
--------------------------------------------------------------------------------
1 | apiVersion: v1
2 | kind: Secret
3 | metadata:
4 |   name: mydockerkey
5 |   namespace: default
6 |   annotations:
7 |     maven.fabric8.io/dockerServerId: ${docker.image.prefix}
8 | type: kubernetes.io/dockercfg


--------------------------------------------------------------------------------
/doc/resources/fabric8/service.yml:
--------------------------------------------------------------------------------
 1 | apiVersion: v1
 2 | kind: Service
 3 | metadata:
 4 |   name: ${project.artifactId}
 5 |   labels:
 6 |     expose: "true"
 7 | spec:
 8 |   ports:
 9 |   - port: 80
10 |     targetPort: 8080
11 |   type: LoadBalancer


--------------------------------------------------------------------------------
/doc/resources/jenkins/DockerfileWithMaven:
--------------------------------------------------------------------------------
 1 | FROM maven:3.5.2-jdk-8-alpine AS MAVEN_TOOL_CHAIN
 2 | 
 3 | ARG dbUrl
 4 | ARG dbKey
 5 | ARG dbName
 6 | 
 7 | ENV DOCUMENTDB_URI=${dbUrl}
 8 | ENV DOCUMENTDB_KEY=${dbKey}
 9 | ENV DOCUMENTDB_DBNAME=${dbName}
10 | 
11 | COPY pom.xml /tmp/
12 | COPY checkstyle.xml /tmp/
13 | COPY src /tmp/src/
14 | WORKDIR /tmp/
15 | RUN mvn package
16 | 
17 | RUN cp /tmp/target/*.jar /app.jar
18 | ENTRYPOINT [ "java", "-jar", "/app.jar", "--server.port=80" ]
19 | 


--------------------------------------------------------------------------------
/doc/resources/jenkins/Jenkinsfile-acr:
--------------------------------------------------------------------------------
 1 | node {
 2 |   stage('init') {
 3 |     // git clone
 4 |     checkout scm
 5 |   }
 6 | 
 7 |   stage('build') {
 8 |     sh 'mvn clean package'
 9 |     acrQuickBuild azureCredentialsId: env.AZURE_CRED_ID,
10 |                   resourceGroupName: env.ACR_RES_GROUP,
11 |                   registryName: env.ACR_NAME,
12 |                   platform: "Linux",
13 |                   dockerfile: "Dockerfile",
14 |                   imageNames: [[image: "$env.ACR_REGISTRY/$env.IMAGE_NAME:$env.BUILD_NUMBER"]]
15 |   }
16 | 
17 |   stage('deploy') {
18 |     acsDeploy azureCredentialsId: env.AZURE_CRED_ID, 
19 |               configFilePaths: 'doc/resources/jenkins/deployment.yml', 
20 |               containerRegistryCredentials: [[credentialsId: env.ACR_CREDENTIAL_ID, url: "http://$env.ACR_REGISTRY"]],
21 |               containerService: "$env.AKS_NAME | AKS",
22 |               enableConfigSubstitution: true, 
23 |               resourceGroupName: env.AKS_RES_GROUP,
24 |               secretName: env.ACR_SECRET
25 |              
26 |     acsDeploy azureCredentialsId: env.AZURE_CRED_ID, 
27 |               configFilePaths: 'doc/resources/jenkins/service.yml', 
28 |               containerService: "$env.AKS_NAME | AKS",
29 |               enableConfigSubstitution: true, 
30 |               resourceGroupName: env.AKS_RES_GROUP
31 |   }
32 | }
33 | 


--------------------------------------------------------------------------------
/doc/resources/jenkins/Jenkinsfile-acr-with-git:
--------------------------------------------------------------------------------
 1 | node {
 2 |    stage('build') {
 3 |     acrQuickBuild azureCredentialsId: env.AZURE_CRED_ID,
 4 |                   resourceGroupName: env.ACR_RES_GROUP,
 5 |                   registryName: env.ACR_NAME,
 6 |                   platform: "Linux",
 7 |                   dockerfile: 'doc/resources/jenkins/DockerfileWithMaven',
 8 |                   gitBranch: '',
 9 |                   gitPath: '',
10 |                   gitRepo: 'https://github.com/Microsoft/todo-app-java-on-azure',
11 |                   imageNames: [[image: "$env.ACR_REGISTRY/$env.IMAGE_NAME:$env.BUILD_NUMBER"]],
12 |                   sourceType: 'git',
13 |                   buildArgs: [[key: 'dbUrl', secrecy: false, value: env.DOCUMENTDB_URI],
14 |                               [key: 'dbKey', secrecy: true, value: env.DOCUMENTDB_KEY],
15 |                               [key: 'dbName', secrecy: false, value: env.DOCUMENTDB_DBNAME]]
16 |   }
17 |  stage('deploy') {
18 |     sh 'wget https://raw.githubusercontent.com/Microsoft/todo-app-java-on-azure/master/doc/resources/jenkins/deployment.yml -O deployment.yml'
19 |     acsDeploy azureCredentialsId: env.AZURE_CRED_ID, 
20 |               configFilePaths: 'deployment.yml', 
21 |               containerRegistryCredentials: [[credentialsId: env.ACR_CREDENTIAL_ID, url: "http://$env.ACR_REGISTRY"]],
22 |               containerService: "$env.AKS_NAME | AKS",
23 |               enableConfigSubstitution: true, 
24 |               resourceGroupName: env.AKS_RES_GROUP,
25 |               secretName: env.ACR_SECRET
26 |     sh 'wget https://raw.githubusercontent.com/Microsoft/todo-app-java-on-azure/master/doc/resources/jenkins/service.yml -O service.yml'             
27 |     acsDeploy azureCredentialsId: env.AZURE_CRED_ID, 
28 |               configFilePaths: 'service.yml', 
29 |               containerService: "$env.AKS_NAME | AKS",
30 |               enableConfigSubstitution: true, 
31 |               resourceGroupName: env.AKS_RES_GROUP
32 |   }
33 | }
34 | 


--------------------------------------------------------------------------------
/doc/resources/jenkins/Jenkinsfile-k8s:
--------------------------------------------------------------------------------
 1 | node {
 2 |   stage('init') {
 3 |     // git clone
 4 |     checkout scm
 5 |   }
 6 | 
 7 |   stage('build') {
 8 |     sh 'mvn clean package'
 9 |   }
10 | 
11 |   stage('deploy') {
12 |     withCredentials([usernamePassword(credentialsId: env.ACR_CRED_ID, usernameVariable: 'ACR_USER', passwordVariable: 'ACR_PASSWORD')]) {
13 |       sh 'docker login -u $ACR_USER -p $ACR_PASSWORD http://$ACR_SERVER'
14 |       // build image
15 |       def imageWithTag = "$env.ACR_SERVER/$env.WEB_APP:$env.BUILD_NUMBER"
16 |       def image = docker.build imageWithTag
17 |       // push image
18 |       image.push()
19 |     }
20 |     kubernetesDeploy credentialsType: 'SSH',
21 |                      ssh: [sshServer: env.ACS_SERVER, sshCredentialsId: env.ACS_CRED_ID],
22 |                      dockerCredentials: [[url: "http://$env.ACR_SERVER", credentialsId: env.ACR_CRED_ID]],
23 |                      secretName: env.ACR_SERVER,
24 |                      configs: 'doc/resources/jenkins/jenkins-sample.yml'
25 |   }
26 | }


--------------------------------------------------------------------------------
/doc/resources/jenkins/Jenkinsfile-webapp:
--------------------------------------------------------------------------------
 1 | node {
 2 |   stage('init') {
 3 |     checkout scm
 4 |   }
 5 |   
 6 |   stage('build') {
 7 |     sh 'mvn clean package'
 8 |   }
 9 |   
10 |   stage('deploy') {
11 |     azureWebAppPublish azureCredentialsId: env.AZURE_CRED_ID, publishType: 'docker',
12 |                        resourceGroup: env.RES_GROUP, appName: env.WEB_APP,
13 |                        dockerImageName: "$env.ACR_SERVER/$env.WEB_APP", dockerImageTag: env.BUILD_NUMBER,
14 |                        dockerRegistryEndpoint: [url: "http://$env.ACR_SERVER", credentialsId: env.ACR_CRED_ID]
15 |   }
16 | }


--------------------------------------------------------------------------------
/doc/resources/jenkins/Jenkinsfile-webapp-se:
--------------------------------------------------------------------------------
 1 | node {
 2 |   stage('init') {
 3 |     checkout scm
 4 |   }
 5 | 
 6 |   stage('build') {
 7 |     sh '''
 8 |         mvn clean package
 9 |         cd target
10 |         cp ../src/main/resources/web.config web.config
11 |         cp todo-app-java-on-azure-1.0-SNAPSHOT.jar app.jar 
12 |         zip todo.zip app.jar web.config
13 |     '''
14 |   }
15 | 
16 |   stage('deploy') {
17 |     azureWebAppPublish azureCredentialsId: env.AZURE_CRED_ID,
18 |                        resourceGroup: env.RES_GROUP, appName: env.WEB_APP, filePath: "**/todo.zip"
19 | 
20 |   }
21 | }


--------------------------------------------------------------------------------
/doc/resources/jenkins/Jenkinsfile-webapp-tomcat:
--------------------------------------------------------------------------------
 1 | node {
 2 |   stage('init') {
 3 |     checkout scm
 4 |   }
 5 | 
 6 |   stage('build') {
 7 |     sh '''
 8 |         mvn clean package
 9 |         mv target/*.war ROOT.war
10 |     '''
11 |   }
12 | 
13 |   stage('deploy') {
14 |     azureWebAppPublish azureCredentialsId: env.AZURE_CRED_ID,
15 |                        resourceGroup: env.RES_GROUP, appName: env.WEB_APP, filePath: "ROOT.war",
16 |                        targetDirectory: "webapps"
17 |   }
18 | }


--------------------------------------------------------------------------------
/doc/resources/jenkins/deployment.yml:
--------------------------------------------------------------------------------
 1 | ---
 2 | kind: Deployment
 3 | apiVersion: extensions/v1beta1
 4 | metadata:
 5 |   name: ${IMAGE_NAME}
 6 |   namespace: default
 7 |   labels:
 8 |     k8s-app: ${IMAGE_NAME}
 9 |     role: ${BUILD_NUMBER}
10 | spec:
11 |   selector:
12 |     matchLabels:
13 |       k8s-app: ${IMAGE_NAME}
14 |   template:
15 |     metadata:
16 |       name: ${IMAGE_NAME}
17 |       labels:
18 |         k8s-app: ${IMAGE_NAME}
19 |         role: "${BUILD_NUMBER}"
20 |     spec:
21 |       containers:
22 |       - name: ${IMAGE_NAME}
23 |         image: "${ACR_REGISTRY}/${IMAGE_NAME}:${BUILD_NUMBER}"
24 |       imagePullSecrets:
25 |       - name: "${ACR_SECRET}"
26 |   strategy:
27 |     type: RollingUpdate
28 |     rollingUpdate:
29 |       maxUnavailable: 25%
30 |       maxSurge: 25%
31 | 


--------------------------------------------------------------------------------
/doc/resources/jenkins/jenkins-sample.yml:
--------------------------------------------------------------------------------
 1 | apiVersion: v1
 2 | kind: "List"
 3 | items:
 4 | - apiVersion: extensions/v1beta1
 5 |   kind: Deployment
 6 |   metadata:
 7 |     name: ${WEB_APP}
 8 |     labels:
 9 |       run: spring
10 |   spec:
11 |     replicas: 1
12 |     selector:
13 |       matchLabels:
14 |         run: spring
15 |     strategy:
16 |       rollingUpdate:
17 |         maxSurge: 1
18 |         maxUnavailable: 1
19 |       type: RollingUpdate
20 |     template:
21 |       metadata:
22 |         labels:
23 |           run: spring
24 |       spec:
25 |         containers:
26 |         - name: ${WEB_APP}
27 |           image: ${ACR_SERVER}/${WEB_APP}:${BUILD_NUMBER}
28 |           ports:
29 |           - containerPort: 80
30 |         imagePullPolicy: Always
31 |         imagePullSecrets:
32 |           - name: ${KUBERNETES_SECRET_NAME}
33 | - apiVersion: v1
34 |   kind: Service
35 |   metadata:
36 |     name: ${WEB_APP}
37 |     labels:
38 |       expose: "true"
39 |   spec:
40 |     selector:
41 |       run: spring
42 |     ports:
43 |     - port: 80
44 |       targetPort: 80
45 |     type: LoadBalancer


--------------------------------------------------------------------------------
/doc/resources/jenkins/service.yml:
--------------------------------------------------------------------------------
 1 | ---
 2 | kind: Service
 3 | apiVersion: v1
 4 | metadata:
 5 |   name: ${IMAGE_NAME}-service
 6 |   namespace: default
 7 |   labels:
 8 |     k8s-app: ${IMAGE_NAME}
 9 |     role: "${BUILD_NUMBER}"
10 | spec:
11 |   ports:
12 |   - name: ${IMAGE_NAME}e-service
13 |     protocol: TCP
14 |     port: 80
15 |     targetPort: 80
16 |   selector:
17 |     k8s-app: ${IMAGE_NAME}
18 |   type: LoadBalancer
19 | 


--------------------------------------------------------------------------------
/doc/resources/jenkins/web.config:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <configuration>
 3 | <system.webServer>
 4 |     <handlers>
 5 |     <add name="httpPlatformHandler" path="*" verb="*" modules="httpPlatformHandler" resourceType="Unspecified" />
 6 |     </handlers>
 7 |     <httpPlatform processPath="%JAVA_HOME%\bin\java.exe"
 8 |         arguments="-Djava.net.preferIPv4Stack=true -Dserver.port=%HTTP_PLATFORM_PORT% -jar &quot;%HOME%\site\wwwroot\${JAR_FILE_NAME}&quot;">
 9 |     </httpPlatform>
10 | </system.webServer>
11 | </configuration>


--------------------------------------------------------------------------------
/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 | #    http://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 | # Maven2 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 Migwn, 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 |   # TODO classpath?
118 | fi
119 | 
120 | if [ -z "$JAVA_HOME" ]; then
121 |   javaExecutable="`which javac`"
122 |   if [ -n "$javaExecutable" ] && ! [ "`expr \"$javaExecutable\" : '\([^ ]*\)'`" = "no" ]; then
123 |     # readlink(1) is not available as standard on Solaris 10.
124 |     readLink=`which readlink`
125 |     if [ ! `expr "$readLink" : '\([^ ]*\)'` = "no" ]; then
126 |       if $darwin ; then
127 |         javaHome="`dirname \"$javaExecutable\"`"
128 |         javaExecutable="`cd \"$javaHome\" && pwd -P`/javac"
129 |       else
130 |         javaExecutable="`readlink -f \"$javaExecutable\"`"
131 |       fi
132 |       javaHome="`dirname \"$javaExecutable\"`"
133 |       javaHome=`expr "$javaHome" : '\(.*\)/bin'`
134 |       JAVA_HOME="$javaHome"
135 |       export JAVA_HOME
136 |     fi
137 |   fi
138 | fi
139 | 
140 | if [ -z "$JAVACMD" ] ; then
141 |   if [ -n "$JAVA_HOME"  ] ; then
142 |     if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
143 |       # IBM's JDK on AIX uses strange locations for the executables
144 |       JAVACMD="$JAVA_HOME/jre/sh/java"
145 |     else
146 |       JAVACMD="$JAVA_HOME/bin/java"
147 |     fi
148 |   else
149 |     JAVACMD="`which java`"
150 |   fi
151 | fi
152 | 
153 | if [ ! -x "$JAVACMD" ] ; then
154 |   echo "Error: JAVA_HOME is not defined correctly." >&2
155 |   echo "  We cannot execute $JAVACMD" >&2
156 |   exit 1
157 | fi
158 | 
159 | if [ -z "$JAVA_HOME" ] ; then
160 |   echo "Warning: JAVA_HOME environment variable is not set."
161 | fi
162 | 
163 | CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher
164 | 
165 | # traverses directory structure from process work directory to filesystem root
166 | # first directory with .mvn subdirectory is considered project base directory
167 | find_maven_basedir() {
168 | 
169 |   if [ -z "$1" ]
170 |   then
171 |     echo "Path not specified to find_maven_basedir"
172 |     return 1
173 |   fi
174 | 
175 |   basedir="$1"
176 |   wdir="$1"
177 |   while [ "$wdir" != '/' ] ; do
178 |     if [ -d "$wdir"/.mvn ] ; then
179 |       basedir=$wdir
180 |       break
181 |     fi
182 |     # workaround for JBEAP-8937 (on Solaris 10/Sparc)
183 |     if [ -d "${wdir}" ]; then
184 |       wdir=`cd "$wdir/.."; pwd`
185 |     fi
186 |     # end of workaround
187 |   done
188 |   echo "${basedir}"
189 | }
190 | 
191 | # concatenates all lines of a file
192 | concat_lines() {
193 |   if [ -f "$1" ]; then
194 |     echo "$(tr -s '\n' ' ' < "$1")"
195 |   fi
196 | }
197 | 
198 | BASE_DIR=`find_maven_basedir "$(pwd)"`
199 | if [ -z "$BASE_DIR" ]; then
200 |   exit 1;
201 | fi
202 | 
203 | export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"}
204 | echo $MAVEN_PROJECTBASEDIR
205 | MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS"
206 | 
207 | # For Cygwin, switch paths to Windows format before running java
208 | if $cygwin; then
209 |   [ -n "$M2_HOME" ] &&
210 |     M2_HOME=`cygpath --path --windows "$M2_HOME"`
211 |   [ -n "$JAVA_HOME" ] &&
212 |     JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"`
213 |   [ -n "$CLASSPATH" ] &&
214 |     CLASSPATH=`cygpath --path --windows "$CLASSPATH"`
215 |   [ -n "$MAVEN_PROJECTBASEDIR" ] &&
216 |     MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"`
217 | fi
218 | 
219 | WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
220 | 
221 | exec "$JAVACMD" \
222 |   $MAVEN_OPTS \
223 |   -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \
224 |   "-Dmaven.home=${M2_HOME}" "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \
225 |   ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@"
226 | 


--------------------------------------------------------------------------------
/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    http://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 Maven2 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 key stroke 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 enable echoing my setting MAVEN_BATCH_ECHO to 'on'
 39 | @if "%MAVEN_BATCH_ECHO%" == "on"  echo %MAVEN_BATCH_ECHO%
 40 | 
 41 | @REM set %HOME% to equivalent of $HOME
 42 | if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%")
 43 | 
 44 | @REM Execute a user defined script before this one
 45 | if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre
 46 | @REM check for pre script, once with legacy .bat ending and once with .cmd ending
 47 | if exist "%HOME%\mavenrc_pre.bat" call "%HOME%\mavenrc_pre.bat"
 48 | if exist "%HOME%\mavenrc_pre.cmd" call "%HOME%\mavenrc_pre.cmd"
 49 | :skipRcPre
 50 | 
 51 | @setlocal
 52 | 
 53 | set ERROR_CODE=0
 54 | 
 55 | @REM To isolate internal variables from possible post scripts, we use another setlocal
 56 | @setlocal
 57 | 
 58 | @REM ==== START VALIDATION ====
 59 | if not "%JAVA_HOME%" == "" goto OkJHome
 60 | 
 61 | echo.
 62 | echo Error: JAVA_HOME not found in your environment. >&2
 63 | echo Please set the JAVA_HOME variable in your environment to match the >&2
 64 | echo location of your Java installation. >&2
 65 | echo.
 66 | goto error
 67 | 
 68 | :OkJHome
 69 | if exist "%JAVA_HOME%\bin\java.exe" goto init
 70 | 
 71 | echo.
 72 | echo Error: JAVA_HOME is set to an invalid directory. >&2
 73 | echo JAVA_HOME = "%JAVA_HOME%" >&2
 74 | echo Please set the JAVA_HOME variable in your environment to match the >&2
 75 | echo location of your Java installation. >&2
 76 | echo.
 77 | goto error
 78 | 
 79 | @REM ==== END VALIDATION ====
 80 | 
 81 | :init
 82 | 
 83 | @REM Find the project base dir, i.e. the directory that contains the folder ".mvn".
 84 | @REM Fallback to current working directory if not found.
 85 | 
 86 | set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR%
 87 | IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir
 88 | 
 89 | set EXEC_DIR=%CD%
 90 | set WDIR=%EXEC_DIR%
 91 | :findBaseDir
 92 | IF EXIST "%WDIR%"\.mvn goto baseDirFound
 93 | cd ..
 94 | IF "%WDIR%"=="%CD%" goto baseDirNotFound
 95 | set WDIR=%CD%
 96 | goto findBaseDir
 97 | 
 98 | :baseDirFound
 99 | set MAVEN_PROJECTBASEDIR=%WDIR%
100 | cd "%EXEC_DIR%"
101 | goto endDetectBaseDir
102 | 
103 | :baseDirNotFound
104 | set MAVEN_PROJECTBASEDIR=%EXEC_DIR%
105 | cd "%EXEC_DIR%"
106 | 
107 | :endDetectBaseDir
108 | 
109 | IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig
110 | 
111 | @setlocal EnableExtensions EnableDelayedExpansion
112 | for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a
113 | @endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS%
114 | 
115 | :endReadAdditionalConfig
116 | 
117 | SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe"
118 | 
119 | set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar"
120 | set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
121 | 
122 | %MAVEN_JAVA_EXE% %JVM_CONFIG_MAVEN_PROPS% %MAVEN_OPTS% %MAVEN_DEBUG_OPTS% -classpath %WRAPPER_JAR% "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %*
123 | if ERRORLEVEL 1 goto error
124 | goto end
125 | 
126 | :error
127 | set ERROR_CODE=1
128 | 
129 | :end
130 | @endlocal & set ERROR_CODE=%ERROR_CODE%
131 | 
132 | if not "%MAVEN_SKIP_RC%" == "" goto skipRcPost
133 | @REM check for post script, once with legacy .bat ending and once with .cmd ending
134 | if exist "%HOME%\mavenrc_post.bat" call "%HOME%\mavenrc_post.bat"
135 | if exist "%HOME%\mavenrc_post.cmd" call "%HOME%\mavenrc_post.cmd"
136 | :skipRcPost
137 | 
138 | @REM pause the script if MAVEN_BATCH_PAUSE is set to 'on'
139 | if "%MAVEN_BATCH_PAUSE%" == "on" pause
140 | 
141 | if "%MAVEN_TERMINATE_CMD%" == "on" exit %ERROR_CODE%
142 | 
143 | exit /B %ERROR_CODE%
144 | 


--------------------------------------------------------------------------------
/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | <project xmlns="http://maven.apache.org/POM/4.0.0"
  3 |          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5 |     <modelVersion>4.0.0</modelVersion>
  6 | 
  7 |     <groupId>com.microsoft.azure</groupId>
  8 |     <artifactId>todo-app-java-on-azure</artifactId>
  9 |     <version>1.0-SNAPSHOT</version>
 10 |     <packaging>jar</packaging>
 11 | 
 12 |     <name>todo-app-java-on-azure</name>
 13 |     <description>A todo list application uses AngularJS and Azure DocumentDB Spring boot starter</description>
 14 | 
 15 |     <parent>
 16 |         <groupId>org.springframework.boot</groupId>
 17 |         <artifactId>spring-boot-starter-parent</artifactId>
 18 |         <version>2.0.3.RELEASE</version>
 19 |     </parent>
 20 | 
 21 |     <properties>
 22 |         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 23 |         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
 24 |         <maven.build.timestamp.format>yyMMddHHmmssSSS</maven.build.timestamp.format>
 25 | 
 26 |         <!-- dependency versions -->
 27 |         <java.version>1.8</java.version>
 28 |         <plugin.fmp.version>3.5.30</plugin.fmp.version>
 29 |         <plugin.spotify.version>0.4.11</plugin.spotify.version>
 30 |         <plugin.azure.webapp.version>0.1.3</plugin.azure.webapp.version>
 31 | 
 32 |         <!-- configurable properties -->
 33 |         <docker.image.prefix>put-your-docker-registry-url</docker.image.prefix>
 34 |         <azure.app.name>todo-app-${maven.build.timestamp}</azure.app.name>
 35 |     </properties>
 36 | 
 37 |     <dependencyManagement>
 38 |         <dependencies>
 39 |             <dependency>
 40 |                 <groupId>com.microsoft.azure</groupId>
 41 |                 <artifactId>azure-spring-boot-bom</artifactId>
 42 |                 <version>2.0.6</version>
 43 |                 <type>pom</type>
 44 |                 <scope>import</scope>
 45 |             </dependency>
 46 |         </dependencies>
 47 |     </dependencyManagement>
 48 | 
 49 |     <dependencies>
 50 |         <dependency>
 51 |             <groupId>org.springframework.boot</groupId>
 52 |             <artifactId>spring-boot-starter-web</artifactId>
 53 |         </dependency>
 54 |         <dependency>
 55 |             <groupId>com.microsoft.azure</groupId>
 56 |             <artifactId>azure-cosmosdb-spring-boot-starter</artifactId>
 57 |         </dependency>
 58 |         <dependency>
 59 |             <groupId>org.springframework.boot</groupId>
 60 |             <artifactId>spring-boot-starter-test</artifactId>
 61 |             <scope>test</scope>
 62 |         </dependency>
 63 |     </dependencies>
 64 | 
 65 |     <build>
 66 |         <plugins>
 67 |             <plugin>
 68 |                 <groupId>org.springframework.boot</groupId>
 69 |                 <artifactId>spring-boot-maven-plugin</artifactId>
 70 |             </plugin>
 71 |             <plugin>
 72 |                 <groupId>com.spotify</groupId>
 73 |                 <artifactId>docker-maven-plugin</artifactId>
 74 |                 <version>${plugin.spotify.version}</version>
 75 |                 <configuration>
 76 |                     <imageName>${docker.image.prefix}/${project.artifactId}</imageName>
 77 |                     <imageTags>
 78 |                         <imageTag>${project.version}</imageTag>
 79 |                     </imageTags>
 80 |                     <baseImage>java</baseImage>
 81 |                     <entryPoint>["java", "-jar", "/${project.build.finalName}.jar"]</entryPoint>
 82 |                     <resources>
 83 |                         <resource>
 84 |                             <targetPath>/</targetPath>
 85 |                             <directory>${project.build.directory}</directory>
 86 |                             <include>${project.build.finalName}.jar</include>
 87 |                         </resource>
 88 |                     </resources>
 89 |                     <registryUrl>https://${docker.image.prefix}</registryUrl>
 90 |                     <serverId>${docker.image.prefix}</serverId>
 91 |                 </configuration>
 92 |             </plugin>
 93 | 
 94 |             <!--*************************************************-->
 95 |             <!-- Deploy to Kubernetes on Azure Container Service -->
 96 |             <!--*************************************************-->
 97 |             <plugin>
 98 |                 <groupId>io.fabric8</groupId>
 99 |                 <artifactId>fabric8-maven-plugin</artifactId>
100 |                 <version>${plugin.fmp.version}</version>
101 |                 <configuration>
102 |                     <ignoreServices>false</ignoreServices>
103 |                     <registry>${docker.image.prefix}</registry>
104 |                 </configuration>
105 |             </plugin>
106 | 
107 |             <!--*************************************************-->
108 |             <!-- Deploy to Azure Web App for Containers          -->
109 |             <!--*************************************************-->
110 |             <plugin>
111 |                 <groupId>com.microsoft.azure</groupId>
112 |                 <artifactId>azure-webapp-maven-plugin</artifactId>
113 |                 <version>${plugin.azure.webapp.version}</version>
114 |                 <configuration>
115 |                     <resourceGroup>java-on-azure</resourceGroup>
116 |                     <appName>${azure.app.name}</appName>
117 |                     <region>westus</region>
118 |                     <pricingTier>s1</pricingTier>
119 |                     <containerSettings>
120 |                         <imageName>${docker.image.prefix}/${project.artifactId}:${project.version}</imageName>
121 |                         <registryUrl>https://${docker.image.prefix}</registryUrl>
122 |                         <serverId>${docker.image.prefix}</serverId>
123 |                     </containerSettings>
124 |                     <appSettings>
125 |                         <property>
126 |                             <name>PORT</name>
127 |                             <value>8080</value>
128 |                         </property>
129 |                     </appSettings>
130 |                 </configuration>
131 |             </plugin>
132 | 
133 |             <plugin>
134 |                 <groupId>org.apache.maven.plugins</groupId>
135 |                 <artifactId>maven-checkstyle-plugin</artifactId>
136 |                 <version>2.17</version>
137 |                 <executions>
138 |                     <execution>
139 |                         <id>validate</id>
140 |                         <phase>validate</phase>
141 |                         <configuration>
142 |                             <configLocation>${project.basedir}/checkstyle.xml</configLocation>
143 |                             <encoding>UTF-8</encoding>
144 |                             <consoleOutput>true</consoleOutput>
145 |                             <failsOnError>true</failsOnError>
146 |                             <failOnViolation>true</failOnViolation>
147 |                             <includeTestSourceDirectory>true</includeTestSourceDirectory>
148 |                             <resourceIncludes>**/*</resourceIncludes>
149 |                         </configuration>
150 |                         <goals>
151 |                             <goal>check</goal>
152 |                         </goals>
153 |                     </execution>
154 |                 </executions>
155 |                 <configuration>
156 |                     <linkXRef>false</linkXRef>
157 |                 </configuration>
158 |                 <inherited>true</inherited>
159 |             </plugin>
160 |         </plugins>
161 |     </build>
162 | </project>
163 | 


--------------------------------------------------------------------------------
/src/main/java/com/microsoft/azure/sample/TodoApplication.java:
--------------------------------------------------------------------------------
 1 | /**
 2 |  * Copyright (c) Microsoft Corporation. All rights reserved.
 3 |  * Licensed under the MIT License. See LICENSE in the project root for
 4 |  * license information.
 5 |  */
 6 | package com.microsoft.azure.sample;
 7 | 
 8 | import org.springframework.boot.SpringApplication;
 9 | import org.springframework.boot.autoconfigure.SpringBootApplication;
10 | 
11 | @SpringBootApplication
12 | public class TodoApplication {
13 | 
14 |     public static void main(String[] args) {
15 |         SpringApplication.run(TodoApplication.class, args);
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/main/java/com/microsoft/azure/sample/controller/TodoListController.java:
--------------------------------------------------------------------------------
  1 | /**
  2 |  * Copyright (c) Microsoft Corporation. All rights reserved.
  3 |  * Licensed under the MIT License. See LICENSE in the project root for
  4 |  * license information.
  5 |  */
  6 | package com.microsoft.azure.sample.controller;
  7 | 
  8 | import com.microsoft.azure.sample.dao.TodoItemRepository;
  9 | import com.microsoft.azure.sample.model.TodoItem;
 10 | import org.springframework.beans.factory.annotation.Autowired;
 11 | import org.springframework.http.HttpStatus;
 12 | import org.springframework.http.MediaType;
 13 | import org.springframework.http.ResponseEntity;
 14 | import org.springframework.web.bind.annotation.*;
 15 | 
 16 | import java.util.*;
 17 | 
 18 | @RestController
 19 | public class TodoListController {
 20 | 
 21 |     @Autowired
 22 |     private TodoItemRepository todoItemRepository;
 23 | 
 24 |     public TodoListController() {
 25 |     }
 26 | 
 27 |     @RequestMapping("/home")
 28 |     public Map<String, Object> home() {
 29 |         final Map<String, Object> model = new HashMap<String, Object>();
 30 |         model.put("id", UUID.randomUUID().toString());
 31 |         model.put("content", "home");
 32 |         return model;
 33 |     }
 34 | 
 35 |     /**
 36 |      * HTTP GET
 37 |      */
 38 |     @RequestMapping(value = "/api/todolist/{index}",
 39 |             method = RequestMethod.GET, produces = {MediaType.APPLICATION_JSON_VALUE})
 40 |     public ResponseEntity<?> getTodoItem(@PathVariable("index") String index) {
 41 |         try {
 42 |             return new ResponseEntity<TodoItem>(todoItemRepository.findById(index).get(), HttpStatus.OK);
 43 |         } catch (Exception e) {
 44 |             return new ResponseEntity<String>(index + " not found", HttpStatus.NOT_FOUND);
 45 |         }
 46 |     }
 47 | 
 48 |     /**
 49 |      * HTTP GET ALL
 50 |      */
 51 |     @RequestMapping(value = "/api/todolist", method = RequestMethod.GET, produces = {MediaType.APPLICATION_JSON_VALUE})
 52 |     public ResponseEntity<?> getAllTodoItems() {
 53 |         try {
 54 |             return new ResponseEntity<>(todoItemRepository.findAll(), HttpStatus.OK);
 55 |         } catch (Exception e) {
 56 |             return new ResponseEntity<>("Nothing found", HttpStatus.NOT_FOUND);
 57 |         }
 58 |     }
 59 | 
 60 |     /**
 61 |      * HTTP POST NEW ONE
 62 |      */
 63 |     @RequestMapping(value = "/api/todolist", method = RequestMethod.POST, consumes = MediaType.APPLICATION_JSON_VALUE)
 64 |     public ResponseEntity<String> addNewTodoItem(@RequestBody TodoItem item) {
 65 |         try {
 66 |             item.setID(UUID.randomUUID().toString());
 67 |             todoItemRepository.save(item);
 68 |             return new ResponseEntity<String>("Entity created", HttpStatus.CREATED);
 69 |         } catch (Exception e) {
 70 |             return new ResponseEntity<String>("Entity creation failed", HttpStatus.CONFLICT);
 71 |         }
 72 |     }
 73 | 
 74 |     /**
 75 |      * HTTP PUT UPDATE
 76 |      */
 77 |     @RequestMapping(value = "/api/todolist", method = RequestMethod.PUT, consumes = MediaType.APPLICATION_JSON_VALUE)
 78 |     public ResponseEntity<String> updateTodoItem(@RequestBody TodoItem item) {
 79 |         try {
 80 |             todoItemRepository.deleteById(item.getID());
 81 |             todoItemRepository.save(item);
 82 |             return new ResponseEntity<String>("Entity updated", HttpStatus.OK);
 83 |         } catch (Exception e) {
 84 |             return new ResponseEntity<String>("Entity updating failed", HttpStatus.NOT_FOUND);
 85 |         }
 86 |     }
 87 | 
 88 |     /**
 89 |      * HTTP DELETE
 90 |      */
 91 |     @RequestMapping(value = "/api/todolist/{id}", method = RequestMethod.DELETE)
 92 |     public ResponseEntity<String> deleteTodoItem(@PathVariable("id") String id) {
 93 |         try {
 94 |             todoItemRepository.deleteById(id);
 95 |             return new ResponseEntity<String>("Entity deleted", HttpStatus.OK);
 96 |         } catch (Exception e) {
 97 |             return new ResponseEntity<String>("Entity deletion failed", HttpStatus.NOT_FOUND);
 98 |         }
 99 | 
100 |     }
101 | }
102 | 


--------------------------------------------------------------------------------
/src/main/java/com/microsoft/azure/sample/dao/TodoItemRepository.java:
--------------------------------------------------------------------------------
 1 | /**
 2 |  * Copyright (c) Microsoft Corporation. All rights reserved.
 3 |  * Licensed under the MIT License. See LICENSE in the project root for
 4 |  * license information.
 5 |  */
 6 | package com.microsoft.azure.sample.dao;
 7 | 
 8 | import com.microsoft.azure.sample.model.TodoItem;
 9 | import com.microsoft.azure.spring.data.cosmosdb.repository.DocumentDbRepository;
10 | import org.springframework.stereotype.Repository;
11 | 
12 | @Repository
13 | public interface TodoItemRepository extends DocumentDbRepository<TodoItem, String> {
14 | }
15 | 


--------------------------------------------------------------------------------
/src/main/java/com/microsoft/azure/sample/model/TodoItem.java:
--------------------------------------------------------------------------------
 1 | /**
 2 |  * Copyright (c) Microsoft Corporation. All rights reserved.
 3 |  * Licensed under the MIT License. See LICENSE in the project root for
 4 |  * license information.
 5 |  */
 6 | package com.microsoft.azure.sample.model;
 7 | 
 8 | import com.microsoft.azure.spring.data.cosmosdb.core.mapping.Document;
 9 | 
10 | import java.util.Objects;
11 | 
12 | @Document
13 | public class TodoItem {
14 |     private String id;
15 |     private String description;
16 |     private String owner;
17 |     private boolean finished;
18 | 
19 |     public TodoItem() {
20 |     }
21 | 
22 |     public TodoItem(String id, String description, String owner) {
23 |         this.description = description;
24 |         this.id = id;
25 |         this.owner = owner;
26 |         this.finished = false;
27 |     }
28 | 
29 |     public boolean isFinished() {
30 |         return finished;
31 |     }
32 | 
33 |     public void setFinish(boolean finished) {
34 |         this.finished = finished;
35 |     }
36 | 
37 |     public String getDescription() {
38 |         return description;
39 |     }
40 | 
41 |     public void setDescription(String description) {
42 |         this.description = description;
43 |     }
44 | 
45 |     public String getOwner() {
46 |         return owner;
47 |     }
48 | 
49 |     public void setOwner(String owner) {
50 |         this.owner = owner;
51 |     }
52 | 
53 |     public String getID() {
54 |         return id;
55 |     }
56 | 
57 |     public void setID(String id) {
58 |         this.id = id;
59 |     }
60 | 
61 |     @Override
62 |     public boolean equals(Object o) {
63 |         if (o == this) {
64 |             return true;
65 |         }
66 |         if (!(o instanceof TodoItem)) {
67 |             return false;
68 |         }
69 |         final TodoItem group = (TodoItem) o;
70 |         return Objects.equals(this.getDescription(), group.getDescription())
71 |                 && Objects.equals(this.getOwner(), group.getOwner())
72 |                 && Objects.equals(this.getID(), group.getID());
73 |     }
74 | 
75 |     @Override
76 |     public int hashCode() {
77 |         return Objects.hash(description, id, owner);
78 |     }
79 | }
80 | 
81 | 


--------------------------------------------------------------------------------
/src/main/resources/application.properties:
--------------------------------------------------------------------------------
1 | azure.cosmosdb.uri=@env.DOCUMENTDB_URI@
2 | azure.cosmosdb.key=@env.DOCUMENTDB_KEY@
3 | azure.cosmosdb.database=@env.DOCUMENTDB_DBNAME@
4 | 


--------------------------------------------------------------------------------
/src/main/resources/static/Scripts/app.js:
--------------------------------------------------------------------------------
 1 | /**
 2 |  * Copyright (c) Microsoft Corporation. All rights reserved.
 3 |  * Licensed under the MIT License. See LICENSE in the project root for
 4 |  * license information.
 5 |  */
 6 | 
 7 | 'use strict';
 8 | angular.module('todoApp', ['ngRoute'])
 9 |     .config(['$routeProvider',  function ($routeProvider) {
10 |         $routeProvider.when('/Home', {
11 |             controller: 'homeCtrl',
12 |             templateUrl: 'Views/Home.html',
13 |         }).when('/TodoList', {
14 |             controller: 'todoListCtrl',
15 |             templateUrl: 'Views/TodoList.html',
16 |         }).otherwise({redirectTo: '/Home'});
17 |     }]);
18 | 


--------------------------------------------------------------------------------
/src/main/resources/static/Scripts/homeCtrl.js:
--------------------------------------------------------------------------------
 1 | /**
 2 |  * Copyright (c) Microsoft Corporation. All rights reserved.
 3 |  * Licensed under the MIT License. See LICENSE in the project root for
 4 |  * license information.
 5 |  */
 6 | 
 7 | 'use strict';
 8 | angular.module('todoApp')
 9 |     .controller('homeCtrl', ['$scope', '$location', function ($scope, $location) {
10 |         $scope.isActive = function (viewLocation) {
11 |             return viewLocation === $location.path();
12 |         };
13 |     }]);
14 | 


--------------------------------------------------------------------------------
/src/main/resources/static/Scripts/todoListCtrl.js:
--------------------------------------------------------------------------------
 1 | /**
 2 |  * Copyright (c) Microsoft Corporation. All rights reserved.
 3 |  * Licensed under the MIT License. See LICENSE in the project root for
 4 |  * license information.
 5 |  */
 6 | 
 7 | 'use strict';
 8 | angular.module('todoApp')
 9 |     .controller('todoListCtrl', ['$scope', '$location', 'todoListSvc', function ($scope, $location, todoListSvc) {
10 |         $scope.error = '';
11 |         $scope.loadingMessage = '';
12 |         $scope.todoList = null;
13 |         $scope.editingInProgress = false;
14 |         $scope.newTodoCaption = '';
15 | 
16 |         $scope.editInProgressTodo = {
17 |             description: '',
18 |             id: 0,
19 |             finish: false
20 |         };
21 | 
22 |         $scope.finishSwitch = function (todo) {
23 |             todoListSvc.putItem(todo).error(function (err) {
24 |                 todo.finished = !todo.finished;
25 |                 $scope.error = err;
26 |                 $scope.loadingMessage = '';
27 |             })
28 |         };
29 | 
30 |         $scope.editSwitch = function (todo) {
31 |             todo.edit = !todo.edit;
32 |             if (todo.edit) {
33 |                 $scope.editInProgressTodo.description = todo.description;
34 |                 $scope.editInProgressTodo.id = todo.id;
35 |                 $scope.editInProgressTodo.finished = todo.finished;
36 |                 $scope.editingInProgress = true;
37 |             } else {
38 |                 $scope.editingInProgress = false;
39 |             }
40 |         };
41 | 
42 |         $scope.populate = function () {
43 |             todoListSvc.getItems().success(function (results) {
44 |                 $scope.todoList = results;
45 |             }).error(function (err) {
46 |                 $scope.error = err;
47 |                 $scope.loadingMessage = '';
48 |             })
49 |         };
50 | 
51 |         $scope.delete = function (id) {
52 |             todoListSvc.deleteItem(id).success(function (results) {
53 |                 $scope.populate();
54 |                 $scope.loadingMessage = results;
55 |                 $scope.error = '';
56 |             }).error(function (err) {
57 |                 $scope.error = err;
58 |                 $scope.loadingMessage = '';
59 |             })
60 |         };
61 | 
62 |         $scope.update = function (todo) {
63 |             todoListSvc.putItem($scope.editInProgressTodo).success(function (results) {
64 |                 $scope.populate();
65 |                 $scope.editSwitch(todo);
66 |                 $scope.loadingMessage = results;
67 |                 $scope.error = '';
68 |             }).error(function (err) {
69 |                 $scope.error = err;
70 |                 $scope.loadingMessage = '';
71 |             })
72 |         };
73 |         
74 |         $scope.add = function () {
75 |             function getUser() {
76 |                 var user = localStorage.getItem('user') || 'unknown';
77 |                 localStorage.setItem('user', user);
78 |                 return user;
79 |             }
80 | 
81 |             todoListSvc.postItem({
82 |                 'description': $scope.newTodoCaption,
83 |                 'owner': getUser(),
84 |                 'finish': 'false'
85 |             }).success(function (results) {
86 |                 $scope.newTodoCaption = '';
87 |                 $scope.populate();
88 |                 $scope.loadingMessage = results;
89 |                 $scope.error = '';
90 |             }).error(function (err) {
91 |                 $scope.error = err;
92 |                 $scope.loadingMsg = '';
93 |             })
94 |         };
95 |     }]);
96 | 


--------------------------------------------------------------------------------
/src/main/resources/static/Scripts/todoListSvc.js:
--------------------------------------------------------------------------------
 1 | /**
 2 |  * Copyright (c) Microsoft Corporation. All rights reserved.
 3 |  * Licensed under the MIT License. See LICENSE in the project root for
 4 |  * license information.
 5 |  */
 6 | 
 7 | 'use strict';
 8 | angular.module('todoApp')
 9 |     .factory('todoListSvc', ['$http', function ($http) {
10 |         return {
11 |             getItems: function () {
12 |                 return $http.get('api/todolist');
13 |             },
14 |             getItem: function (id) {
15 |                 return $http.get('api/todolist/' + id);
16 |             },
17 |             postItem: function (item) {
18 |                 return $http.post('api/todolist/', item);
19 |             },
20 |             putItem: function (item) {
21 |                 return $http.put('api/todolist/', item);
22 |             },
23 |             deleteItem: function (id) {
24 |                 return $http({
25 |                     method: 'DELETE',
26 |                     url: 'api/todolist/' + id
27 |                 });
28 |             }
29 |         };
30 |     }]);
31 | 


--------------------------------------------------------------------------------
/src/main/resources/static/Views/Home.html:
--------------------------------------------------------------------------------
1 | <div class="jumbotron" style="background-color:transparent !important;">
2 |     <h1>Todo List App</h1>
3 |     <p>This project uses AngularJS and Azure documentDB spring boot starter to create a simple todo list app.</p>
4 | </div>
5 | 


--------------------------------------------------------------------------------
/src/main/resources/static/Views/TodoList.html:
--------------------------------------------------------------------------------
 1 | <div ng-init="populate()" style="margin-bottom: 40px !important;">
 2 |     <div style="height: 70px !important;">
 3 |         <div class="alert alert-danger" data-ng-show="error && error !== ''"><strong>Failure!</strong>&nbsp;{{error}}</div>
 4 |         <div class="alert alert-success" data-ng-show="loadingMessage && loadingMessage !== ''"><strong>Success!</strong>&nbsp;{{loadingMessage}}</div>
 5 |     </div>
 6 |     <div class="panel">
 7 |         <div class="input-group" style="margin-bottom: 20px !important;">
 8 |             <input ng-model="newTodoCaption" class="form-control"/>
 9 |             <span class="input-group-btn">
10 |                 <button ng-click="add()" class="btn btn-primary">Add</button>
11 |             </span>
12 |         </div>
13 |         <ul class="list-group" id="todolist">
14 |             <div class="list-group-item list-group-item-action flex-column align-items-start" data-ng-repeat="item in todoList">
15 |                 <div data-ng-hide="item.edit">
16 |                     <button type="button" class="btn btn-success float-right btn-sm" ng-disabled="item.finished" data-ng-click="editSwitch(item)">Edit</button>
17 |                     <button type="button" class="btn btn-danger float-right btn-sm" data-ng-click="delete(item.id)">Delete</button>
18 |                     <input type="checkbox" data-ng-model="item.finished" data-ng-change="finishSwitch(item)"/>
19 |                     <span data-ng-hide="item.finished">{{item.description}}</span>
20 |                     <span data-ng-show="item.finished"><del>{{item.description}}</del></span>
21 |                 </div>
22 |                 <div data-ng-show="item.edit" class="input-group">
23 |                     <input class="form-control" data-ng-model="editInProgressTodo.description" />
24 |                     <span class="input-group-btn">
25 |                         <button type="button" data-ng-click="update(item)" class="btn btn-primary float-right btn-sm">Save</button>
26 |                         <button type="button" data-ng-click="editSwitch(item)"  class="btn btn-secondary float-right btn-sm">Cancel</button>
27 |                     </span>
28 |                 </div>
29 |             </div>
30 |         </ul>
31 |     </div>
32 | </div>
33 | 


--------------------------------------------------------------------------------
/src/main/resources/static/index.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html xmlns="http://www.w3.org/1999/xhtml">
 3 | <head>
 4 |     <meta charset="utf-8" />
 5 |     <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no" />
 6 |     <meta name="theme-color" content="#000000" />
 7 |     <title>Todo List App Java on Azure</title>
 8 |     <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0-beta/css/bootstrap.min.css" />
 9 |     <style>
10 |         .list-group-item { word-wrap: break-word; }
11 |         #todolist button { margin-left: 5px; }
12 |     </style>
13 | </head>
14 | <body ng-app="todoApp" ng-controller="homeCtrl" role="document">
15 | <nav class="navbar fixed-top navbar-expand-sm navbar-dark bg-dark">
16 |     <div class="container">
17 |         <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navBarToggler" aria-controls="navBarToggler" aria-expanded="false" aria-label="Azure Spring Boot Sample">
18 |             <span class="navbar-toggler-icon"></span>
19 |         </button>
20 |         <div class="collapse navbar-collapse" id="navBarToggler">
21 |             <a class="navbar-brand" href="#/Home">Todo List Java on Azure</a>
22 |             <ul class="navbar-nav">
23 |                 <li ng-class="{ active: isActive('/Home') }"><a class="nav-link" href="#/Home">Home</a></li>
24 |                 <li ng-class="{ active: isActive('/TodoList') }"><a class="nav-link" href="#/TodoList">Todo List</a></li>
25 |             </ul>
26 |         </div>
27 |     </div>
28 | </nav>
29 | 
30 | <div class="container" role="main" style="margin-top: 80px !important;">
31 |     <div ng-view class="panel-body">
32 | </div>
33 | </div>
34 | </body>
35 | <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js"></script>
36 | <script src="https://ajax.googleapis.com/ajax/libs/angularjs/1.2.25/angular.min.js"></script>
37 | <script src="https://code.angularjs.org/1.2.25/angular-route.js"></script>
38 | <script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js"></script>
39 | <script src="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0-beta/js/bootstrap.min.js"></script>
40 | <script src="Scripts/app.js"></script>
41 | <script src="Scripts/homeCtrl.js"></script>
42 | <script src="Scripts/todoListCtrl.js"></script>
43 | <script src="Scripts/todoListSvc.js"></script>
44 | </html>
45 | 


--------------------------------------------------------------------------------
/src/test/java/com/microsoft/azure/sample/TodoApplicationTest.java:
--------------------------------------------------------------------------------
  1 | /**
  2 |  * Copyright (c) Microsoft Corporation. All rights reserved.
  3 |  * Licensed under the MIT License. See LICENSE in the project root for
  4 |  * license information.
  5 |  */
  6 | package com.microsoft.azure.sample;
  7 | 
  8 | import static org.junit.Assert.*;
  9 | import static org.mockito.BDDMockito.*;
 10 | import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
 11 | import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
 12 | import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.delete;
 13 | import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.put;
 14 | import static org.springframework.test.web.servlet.result.MockMvcResultHandlers.print;
 15 | import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
 16 | import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.forwardedUrl;
 17 | import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
 18 | 
 19 | import java.util.ArrayList;
 20 | import java.util.HashMap;
 21 | import java.util.Map;
 22 | import java.util.Optional;
 23 | 
 24 | import org.junit.After;
 25 | import org.junit.Before;
 26 | import org.junit.Test;
 27 | import org.junit.runner.RunWith;
 28 | import org.mockito.invocation.InvocationOnMock;
 29 | import org.springframework.beans.factory.annotation.Autowired;
 30 | import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest;
 31 | import org.springframework.boot.test.mock.mockito.MockBean;
 32 | import org.springframework.http.MediaType;
 33 | import org.springframework.test.context.TestPropertySource;
 34 | import org.springframework.test.context.junit4.SpringRunner;
 35 | import org.springframework.test.web.servlet.MockMvc;
 36 | 
 37 | import com.microsoft.azure.sample.controller.TodoListController;
 38 | import com.microsoft.azure.sample.dao.TodoItemRepository;
 39 | import com.microsoft.azure.sample.model.TodoItem;
 40 | 
 41 | @RunWith(SpringRunner.class)
 42 | @TestPropertySource(locations = "classpath:test.properties")
 43 | @WebMvcTest(TodoListController.class)
 44 | public class TodoApplicationTest {
 45 |     static final String MOCK_ID = "mockId";
 46 |     static final String MOCK_DESC = "Mock Item";
 47 |     static final String MOCK_OWNER = "Owner of mock item";
 48 |     final Map<String, TodoItem> repository = new HashMap<>();
 49 |     final TodoItem mockItemA = new TodoItem(MOCK_ID + "-A", MOCK_DESC + "-A", MOCK_OWNER + "-A");
 50 |     final TodoItem mockItemB = new TodoItem(MOCK_ID + "-B", MOCK_DESC + "-B", MOCK_OWNER + "-B");
 51 | 
 52 |     @Autowired
 53 |     private MockMvc mockMvc;
 54 | 
 55 |     @MockBean
 56 |     private TodoItemRepository todoItemRepository;
 57 | 
 58 |     @Before
 59 |     public void setUp() {
 60 |         repository.clear();
 61 |         repository.put(mockItemA.getID(), mockItemA);
 62 |         repository.put(mockItemB.getID(), mockItemB);
 63 | 
 64 |         given(this.todoItemRepository.save(any(TodoItem.class))).willAnswer((InvocationOnMock invocation) -> {
 65 |             final TodoItem item = invocation.getArgument(0);
 66 |             if (repository.containsKey(item.getID())) {
 67 |                 throw new Exception("Conflict.");
 68 |             }
 69 |             repository.put(item.getID(), item);
 70 |             return item;
 71 |         });
 72 | 
 73 |         given(this.todoItemRepository.findById(any(String.class))).willAnswer((InvocationOnMock invocation) -> {
 74 |             final String id = invocation.getArgument(0);
 75 |             return Optional.of(repository.get(id));
 76 |         });
 77 | 
 78 |         given(this.todoItemRepository.findAll()).willAnswer((InvocationOnMock invocation) -> {
 79 |             return new ArrayList<TodoItem>(repository.values());
 80 |         });
 81 | 
 82 |         willAnswer((InvocationOnMock invocation) -> {
 83 |             final String id = invocation.getArgument(0);
 84 |             if (!repository.containsKey(id)) {
 85 |                 throw new Exception("Not Found.");
 86 |             }
 87 |             repository.remove(id);
 88 |             return null;
 89 |         }).given(this.todoItemRepository).deleteById(any(String.class));
 90 |     }
 91 | 
 92 |     @After
 93 |     public void tearDown() {
 94 |         repository.clear();
 95 |     }
 96 | 
 97 |     @Test
 98 |     public void shouldRenderDefaultTemplate() throws Exception {
 99 |         mockMvc.perform(get("/")).andDo(print()).andExpect(status().isOk()).andExpect(forwardedUrl("index.html"));
100 |     }
101 | 
102 |     @Test
103 |     public void canGetTodoItem() throws Exception {
104 |         mockMvc.perform(get(String.format("/api/todolist/%s", mockItemA.getID()))).andDo(print())
105 |                 .andExpect(status().isOk())
106 |                 .andExpect(content().json(String.format("{\"id\":\"%s\",\"description\":\"%s\",\"owner\":\"%s\"}",
107 |                         mockItemA.getID(), mockItemA.getDescription(), mockItemA.getOwner())));
108 |     }
109 | 
110 |     @Test
111 |     public void canGetAllTodoItems() throws Exception {
112 |         mockMvc.perform(get("/api/todolist")).andDo(print()).andExpect(status().isOk()).andExpect(content()
113 |                 .json(String.format("[{\"id\":\"%s\"}, {\"id\":\"%s\"}]", mockItemA.getID(), mockItemB.getID())));
114 |     }
115 | 
116 |     @Test
117 |     public void canSaveTodoItems() throws Exception {
118 |         final int size = repository.size();
119 |         final TodoItem mockItemC = new TodoItem(null, MOCK_DESC + "-C", MOCK_OWNER + "-C");
120 |         mockMvc.perform(post("/api/todolist").contentType(MediaType.APPLICATION_JSON_VALUE).content(String
121 |                 .format("{\"description\":\"%s\",\"owner\":\"%s\"}", mockItemC.getDescription(), mockItemC.getOwner())))
122 |                 .andDo(print()).andExpect(status().isCreated());
123 |         assertTrue(size + 1 == repository.size());
124 |     }
125 | 
126 |     @Test
127 |     public void canDeleteTodoItems() throws Exception {
128 |         final int size = repository.size();
129 |         mockMvc.perform(delete(String.format("/api/todolist/%s", mockItemA.getID()))).andDo(print())
130 |                 .andExpect(status().isOk());
131 |         assertTrue(size - 1 == repository.size());
132 |         assertFalse(repository.containsKey(mockItemA.getID()));
133 |     }
134 | 
135 |     @Test
136 |     public void canUpdateTodoItems() throws Exception {
137 |         final String newItemJsonString = String.format("{\"id\":\"%s\",\"description\":\"%s\",\"owner\":\"%s\"}",
138 |                 mockItemA.getID(), mockItemA.getDescription(), "New Owner");
139 |         mockMvc.perform(put("/api/todolist").contentType(MediaType.APPLICATION_JSON_VALUE).content(newItemJsonString))
140 |                 .andDo(print()).andExpect(status().isOk());
141 |         assertTrue(repository.get(mockItemA.getID()).getOwner().equals("New Owner"));
142 |     }
143 | 
144 |     @Test
145 |     public void canNotDeleteNonExistingTodoItems() throws Exception {
146 |         final int size = repository.size();
147 |         mockMvc.perform(delete(String.format("/api/todolist/%s", "Non-Existing-ID"))).andDo(print())
148 |                 .andExpect(status().isNotFound());
149 |         assertTrue(size == repository.size());
150 |     }
151 | 
152 |     /**
153 |      * PUT should be idempotent.
154 |      */
155 |     @Test
156 |     public void idempotenceOfPut() throws Exception {
157 |         final String newItemJsonString = String.format("{\"id\":\"%s\",\"description\":\"%s\",\"owner\":\"%s\"}",
158 |                 mockItemA.getID(), mockItemA.getDescription(), "New Owner");
159 |         mockMvc.perform(put("/api/todolist").contentType(MediaType.APPLICATION_JSON_VALUE).content(newItemJsonString))
160 |                 .andDo(print()).andExpect(status().isOk());
161 |         final TodoItem firstRes = repository.get(mockItemA.getID());
162 |         mockMvc.perform(put("/api/todolist").contentType(MediaType.APPLICATION_JSON_VALUE).content(newItemJsonString))
163 |                 .andDo(print()).andExpect(status().isOk());
164 |         final TodoItem secondRes = repository.get(mockItemA.getID());
165 |         assertTrue(firstRes.equals(secondRes));
166 |     }
167 | }
168 | 


--------------------------------------------------------------------------------
/src/test/java/com/microsoft/azure/sample/model/TodoItemTest.java:
--------------------------------------------------------------------------------
 1 | /**
 2 |  * Copyright (c) Microsoft Corporation. All rights reserved.
 3 |  * Licensed under the MIT License. See LICENSE in the project root for
 4 |  * license information.
 5 |  */
 6 | package com.microsoft.azure.sample.model;
 7 | 
 8 | import static org.junit.Assert.*;
 9 | 
10 | import org.junit.Test;
11 | 
12 | public class TodoItemTest {
13 | 
14 |     @Test
15 |     public void testEqualsObject() {
16 |         final TodoItem itemA = new TodoItem();
17 |         final TodoItem itemB1 = new TodoItem("B", "Item B", "Owner of Item B");
18 |         final TodoItem itemB2 = new TodoItem("B", "Item B", "Owner of Item B");
19 |         final Object nonTodoItem = new Object();
20 |         assertTrue(itemA.equals(itemA));
21 |         assertFalse(itemA.equals(null));
22 |         assertFalse(itemA.equals(nonTodoItem));
23 |         assertFalse(itemA.equals(itemB1));
24 |         assertTrue(itemB1.equals(itemB2));
25 |         assertFalse(itemB1.equals(itemA));
26 |     }
27 | 
28 | }
29 | 


--------------------------------------------------------------------------------
/src/test/resources/test.properties:
--------------------------------------------------------------------------------
1 | azure.keyvault.enabled=false
2 | 


--------------------------------------------------------------------------------