CloudBread-ARM

This project is automatic provision script for CloudBread service instances on Cloud.

This document introduces the recipe for the deploy CloudBread to Azure. First, we deploy Azure resources used in CloudBread with ARM (Azure Resource Manager). Next, we install CloudBread on the resources we deployed in the previous step. Finally, we need to create database. Now, you can deploy your game server very easy with this document.

1. Deploy resources used in CloudBread to Azure

We will use ARM(Microsoft Azure Resource Manager). It is very powerful tools for automatic deployment on Azure.

1) Fork the Cloudbread-ARM to personal repository.

2) Click the [Deploy to Azure] button.

Please click the button above.

3) Make a new resource group, or use the existed resource group.

4) Fill in the blanks about parameter. and Click the [OK] button.

you can see the detailed explanation for the parameters.

Parameter info

When you click upper buttons, maybe you can see Microsoft Azure Template Deploy Pages, and then you have to write this parameters. Red star mark is the required parameters.

Required	Parameter Name	Remarks
*	Administrator Login	This is for SQL Server. It will be used for SQL User ID.
*	Administrator Login Password	This is for SQL Server, too. It will be used for SQL User Password.
*	Database Name	This parameter is for Database name
*	Storage Name	This is Storage Account. So you can't use duplicated string account like ID.

you must remember the parameters marked with required in the table above. They're admin account for CloudBread's DB and storage.

5) Wait for 15~20 minutes, and then deployment was completed!

Generated Resources

Name	Resource	Detail
Group Name	Resource Group
cb-core-<GroupID>	Mobile App	This is a very important part. This is a core server that communicates with users' smartphones.
cb-redis-<GroupID>	Redis	It is a redis cache server for quickly processing user data in database. (i.g.the leader board, handling massive game log data saving queue, real time socket Authentication and so on.)
cb-sqlserver-<GroupID>	SQL Server
<Database Name>	SQL Database	CloudBread Database.
<Storage Name>	Storage Account
cb-core-hostingplan-<GroupID>	App Service Plan	It is Hosting Plan for cb-core-<GroupID>. If you want to do up-scale or down-scale, change this plan.
cb-sub-hostingplan-<GroupID>	App Service Plan	It is Hosting Plan for cb-adminweb-<GroupID> and cb-socket-<GroupID>.
cb-adminweb-<GroupID>	API App	It is for admin web included in CloudBread Projects.
cb-socket-<GroupID>	API App	This is used as authentication server for socket server.

* ```<GroupID>``` is generated automatically with Resource Group.

2. Install CloudBread on the resources

We use the Continuous Deployment. This is very convenient to use with GitHub's repositories.

1) Now you have to go to CloudBread repository and clone it to your personal repository.

2) Open your Azure Cloud Portal, and go to your resource group deployed before.

3) Find Mobile App and click it. (Maybe its name is cb-core-<GroupID>)

4) In the MobileApp, click setting and find Continuous deployment.

5) Choose source what you want.

6.GitHub -> you must have the Cloudbread repository that you forked previously. select the all of things as below screen, and click the [OK] button.

7.Now, Continuous deployment success!

3. Create database for CloudBread

This is final steps for use CloudBread Game Server.

Now you can see this documents.

https://github.com/CloudBreadProject/CloudBread-DB-Install-Script

Limiation of BizSaprk datacenter region issue

Regarding to BizSpark enroll duration, deployment on some region limited - reported from facebook group Jung Hoon Baek.

• Could not select Japan area but Southeast Asia.

It's limitation of BizSaprk program.

By default, CloudBread is using Japan, East Asia. You might need to change ARM script region and execute it on your machine.
https://docs.microsoft.com/en-us/azure/azure-resource-manager/resource-group-overview

Refer issue #22 - CloudBreadProject#22

"code": "40856",  
  "message": "Location 'Japan West' is not accepting creation of new Azure SQL Database Servers of version '12.0' at this time.  This location only supports the following server versions: ''.  Please retry using a supported server version.",  
  "target": null,  
  "details": [  
    {  
      "code": "40856",  
      "message": "Location 'Japan West' is not accepting creation of new Azure SQL Database Servers of version '12.0' at this time.  This location only supports the following server versions: ''.  Please retry using a supported server version.",
      "target": null,
      "severity": "16"  
    }  
  ],  
  "innererror": []  
}