Awesome
WARNING: This repository is no longer maintained :warning:
<p align="center"> <a href="http://kitura.io/"> <img src="https://raw.githubusercontent.com/IBM-Swift/Kitura/master/Sources/Kitura/resources/kitura-bird.svg?sanitize=true" height="100" alt="Kitura"> </a> </p> <p align="center"> <a href="https://cloud.ibm.com"> <img src="https://img.shields.io/badge/IBM%20Cloud-powered-blue.svg" alt="IBM Cloud"> </a> <img src="https://img.shields.io/badge/platform-swift-lightgrey.svg?style=flat" alt="platform"> <img src="https://img.shields.io/badge/os-macOS-green.svg?style=flat" alt="macOS"> <img src="https://img.shields.io/badge/os-linux-green.svg?style=flat" alt="Linux"> <img src="https://img.shields.io/badge/license-Apache2-blue.svg?style=flat" alt="Apache 2"> <a href="http://swift-at-ibm-slack.mybluemix.net/"> <img src="http://swift-at-ibm-slack.mybluemix.net/badge.svg" alt="Slack Status"> </a> </p>This repository will not be updated. The repository will be kept available in read-only mode.
Create and deploy a Swift Kitura application
We have applications available for Node.js Express, Go Gin, Python Flask, Python Django, Java Spring, Java Liberty, Swift Kitura, Android, and iOS.
In this sample application, you will create a basic web application using Kitura to serve web pages in Swift, complete with standard best practices, including a health check.
Steps
Deploying to IBM Cloud
IBM Cloud DevOps services provides toolchains as a set of tool integrations that support development, deployment, and operations tasks inside IBM Cloud.
Building Locally
To get started building this application locally, you can either run the application natively or use the IBM Cloud Developer Tools for containerization and easy deployment to IBM Cloud.
Native Application Development
- On Linux, install the Swift toolchain version v5.1.
- On macOS, install Xcode v11+
In the root of this project, first build the application using swift build. swift run will launch the application and render it at http://localhost:8080. You can also verify the state of your locally running application using the Selenium UI test script included in the scripts directory.
IBM Cloud Developer Tools
Install IBM Cloud Developer Tools on your machine by running the following command:
curl -sL https://ibm.biz/idt-installer | bash
Create an application on IBM Cloud by running:
ibmcloud dev create
This will create and download a starter application with the necessary files needed for local development and deployment.
Your application will be compiled with Docker containers. To compile and run your app, run:
ibmcloud dev build
ibmcloud dev run
This will launch your application locally. When you are ready to deploy to IBM Cloud on Kubernetes, run one of the commands:
ibmcloud dev deploy -t container // to K8s cluster
You can build and debug your app locally with:
ibmcloud dev build --debug
ibmcloud dev debug
Next Steps
- Learn more about augmenting your Swift applications on IBM Cloud with the Swift Programming Guide.
- Explore Kitura.io for more resources about the Kitura framework.
- Join the Swift@IBM slack to get help with your projects.
License
This sample application is licensed under the Apache License, Version 2. Separate third-party code objects invoked within this code pattern are licensed by their respective providers pursuant to their own separate licenses. Contributions are subject to the Developer Certificate of Origin, Version 1.1 and the Apache License, Version 2.