Ballerina Distribution
The Ballerina distribution includes both platform and runtime components.
About Ballerina
Ballerina makes it easy to write microservices that integrate APIs.
Integration Syntax
A compiled, transactional, statically and strongly typed programming language with textual and graphical syntaxes. Ballerina incorporates fundamental concepts of distributed system integration and offers a type safe, concurrent environment to implement microservices.
Networked Type System
A type system that embraces network payload variability with primitive, object, union, and tuple types.
Concurrency
An execution model composed of lightweight parallel worker units that are non-blocking where no function can lock an executing thread manifesting sequence concurrency.
Table of contents
Getting started
You can use one of the following options to try out Ballerina.
Download and install
Download the binary
You can download the Ballerina distribution at http://ballerina.io.
Install from source
Alternatively, you can install Ballerina from the source using the following instructions.
Prerequisites
Building the source
-
Clone this repository using the following command.
git clone --recursive https://github.com/ballerina-platform/ballerina-lang
-
This repository is depending on Github packages. You need to have a personnel access token with read package permissions. Then you need to set following environment variables.
export packageUser=<Your github username> export packagePAT=<Your personnel access token>
-
Run the Maven command
mvn -s settings.xml clean install
from the repository root directory. -
Extract the Ballerina distribution created at
ballerina/target/ballerina-<version>-SNAPSHOT.zip
.
Contributing to Ballerina
As an open source project, Ballerina welcomes contributions from the community. To start contributing, read these contribution guidelines for information on how you should go about contributing to our project.
Check the issue tracker for open issues that interest you. We look forward to receiving your contributions.
License
Ballerina code is distributed under Apache license 2.0.
Useful links
- The ballerina-dev@googlegroups.com mailing list is for discussing code changes to the Ballerina project.
- Chat live with us on our Slack channel.
- Technical questions should be posted on Stack Overflow with the #ballerina tag.