Skip to content

Latest commit

 

History

History
114 lines (91 loc) · 4.46 KB

DeployToCloud.md

File metadata and controls

114 lines (91 loc) · 4.46 KB

Deploying the Kitura FoodServer to IBM Cloud

Pre-Requisites:

Create a free IBM Cloud Account
Go to the following URL, fill out the form and press "Create Account":
https://console.bluemix.net/registration?cm_sp=dw-bluemix-_-swift-_-devcenter

Install the IBM Developer Tools
Run the init command of the Kitura CLI:

kitura idt

Obtain a GitHub ID
Go to the following URL, enter Username, Email and Password and press "Sign up for GitHub":
https://github.com/

Install the Git CLI
brew install git

Building and Testing on Linux

Before deploying to the cloud, it is useful to be able to build and test the Kitura application on Linux to ensure that it will compile and run when deployed. The Kitura CLI uses three features of the IBM Developer Tools: build, run and test to allow you to easily verify your application locally.

1: Build your Kitura application locally for Linux

  1. Go to the root directory of your FoodTrackerServer project 
    cd ~/FoodTrackerBackend/FoodServer/
  2. Build your Kitura application for Linux: 
    kitura build
    This builds your Kitura application using a Linux Ubuntu 14.04 Docker container locally on your laptop, ensuring that the application will compile successfull when deployed to the cloud.
  3. Run you Kitura application on Linux 
    kitura run
    This runs your Kitura application inside the Linux Docker container, verifying that it will run when deployed to the Cloud. Once the application is running you can connect to its URLs on localhost as before, eg:
  4. If you have created tests for your application that are runnable using swift test you can also execute those using: 
    idt test

Deploying to IBM Cloud

There are two main methods to deploying your application to IBM Cloud:

  1. Using the IBM Developer Tools CLI
  2. Using the IBM Cloud DevOps pipelines

Option 1: IBM Developer Tools (IDT)

  1. Go to the root directory of your FoodTrackerServer project

    cd ~/FoodTrackerBackend/FoodServer/

  2. Log in to IBM Cloud

    bluemix api https://api.ng.bluemix.net
bluemix login
bluemix target -o <YOUR_ORG> -s <YOUR_DEV_SPACE>

    where YOUR_ORG is the organisation you used when signing up to IBM Cloud and YOUR_DEV_SPACE is the space you created.

  3. Deploy your application to IBM Cloud

    idt deploy

  4. Open your browser to the deployed provided URL to see the application running. You can now update the URL used with KituraKit in the FoodTracker application to connect from the iOS app.

Option 2: IBM Cloud DevOps Pipelines

In order to use the IBM Cloud DevOps pipelines to build, test and deploy your project, you need to host your project in a Git repositiory that is visible to IBM Cloud. The easiest way to do this is using GitHub.

Create a GitHub project

  1. Go to your GitHub account
    http://github.com
  2. Go to your profile by clicking on your avatar in the top right hand corner.
  3. Select the "Repositorites" tab
  4. Select the green "New" button
  5. Give your repository a name and press "Create repository"
    Note: Keep this page for use later

Create a Local Git Project

  1. Go to the root directory of your FoodTrackerServer project
cd ~/FoodTrackerBackend-Workshop/Server/FoodTrackerServer/

  1. Initialise a local git project
    git init

  2. Add all your files to the project
    git add -A

  3. Check those file in by as a "commit"
    git commit -m "Initial commit"

  4. Push the commit to GitHub
    Use the two lines under "…or push an existing repository from the command line" from the page dispalyed when you created your GitHub page.

  5. Reload the GitHub project page

Create an IBM Cloud DevOps Toolchain for your project

  1. Click the "Create Toolchain" button under the "Bluemix toolchain" section of the README.md of your GitHub project.
  2. If needed, login to IBM Cloud using your credentials
  3. Click the "Create" button
  4. Click on the "Delivery Pipeline" tile
  5. Wait for the "Deploy Stage" to complete
  6. Click the link under "Last Execution Result" to check that the Kitura server is running once its status button turns green.
  7. Open your browser to the deployed provided URL to see the application running. You can now update the URL used with KituraKit in the FoodTracker application to connect from the iOS app.