Bluemix starter application for Kitura web framework and HTTP server

Summary

Kitura-Starter-Bluemix is a Kitura based server application that you can use as a starting point to get your own Kitura application up and running on Bluemix. After cloning this GitHub repo to your local system, you can deploy this application to Bluemix right away. If you'd also like to run Kitura-Starter-Bluemix locally, then see the instructions for installation on OS X or installation on Linux for details on system level dependencies you may need before attempting to execute this app.

Swift version

This version of Kitura-Starter-Bluemix works with the DEVELOPMENT-SNAPSHOT-2016-06-06-a version of the Swift binaries. You can download this version of the Swift binaries by following this link. Compatibility with other Swift versions is not guaranteed.

Clone, build, and run

1. Clone this repo using git clone https://github.com/IBM-Swift/Kitura-Starter-Bluemix.git and go to the root folder using cd Kitura-Starter-Bluemix. Please do not use the GitHub Download ZIP button as a way to clone this repo.

2. Compile and execute the server app using: make run. Once the server starts, you should see the message Listening on port 8090. The executable file is located in the .build/debug directory: ./.build/debug/Kitura-Starter-Bluemix.

3. Open your browser at http://localhost:8090.

4. Access static content using the following URL:http://localhost:8090/static.

Pushing the application to Bluemix

Using the Deploy to Bluemix button

Clicking on the button below deploys this sample application to Bluemix. The manifest.yml file [included in the repo] is parsed to obtain the name of the application and configuration details. For further details on the structure of the manifest.yml file, see the Cloud Foundry documentation.

Once deployment to Bluemix is completed, you should access the route assigned to your application using the web browser of your choice. You should see the Kitura welcome page!

Note that the Bluemix buildpack for Swift is used for the deployment of BluePic to Bluemix. This buildpack is currently installed in the following Bluemix regions: US South, United Kingdom, and Sydney.

Using the Cloud Foundry command line

You should have the Cloud Foundry command line installed on your system and you should be already logged on to Bluemix before you attempt the following steps.

1. From the root folder of this repo on your local system, execute cf push.

2. Once the application is pushed to and running on Bluemix, you can access your application route to see Kitura's welcome page on your browser.

Kitura Wiki

Feel free to visit our Wiki for our roadmap and some tutorials.

License

The Kitura-Starter-Bluemix sample app is licensed under Apache 2.0. Full license text is available in LICENSE.