ballerina/ballerina-runtime repository overview

⁠Supported tags and respective Dockerfile links

• 0.991.0, latest⁠
• 0.990.4⁠
• 0.990.3⁠
• 0.990.2⁠
• 0.990.1⁠
• 0.990.0⁠
• 0.983.0⁠

Supported with the latest release of docker⁠ (down to 1.6 on a best-effort basis)

⁠Quick reference

• Where to get help: https://ballerina.io/help/⁠

• Maintained by: The Ballerina Community⁠

⁠What is Ballerina?

Ballerina makes it easy to create resilient services that integrate and orchestrate transactions across distributed endpoints.

The future apps we write increasingly depend upon programmable endpoints. The discipline of resilient communication between endpoints is integration. It is a domain of hard problems.

Ballerina is a simple programming language whose syntax and runtime address the hard problems of integration. Ballerina is a general purpose, concurrent, transactional, statically and strongly typed programming language with both textual and graphical syntaxes. Its specialization is integration - it brings fundamental concepts, ideas and tools of distributed system integration into the language and offers a type-safe, concurrent environment to implement such applications. These include distributed transactions, reliable messaging, stream processing, workflows and container management platforms.

Refer Ballerina Philosophy⁠ and Ballerina Documentation⁠ for more info.

⁠How to use this image

This image contains a Ballerina runtime distribution for running a Ballerina file (.bal) or a compiled Ballerina program (.balx). The runtime distribution cannot be used to compile a Ballerina program. The ballerina-platform image⁠ is an image with Ballerina toolset included and can be used to compile and run Ballerina programs.

• Run a Ballerina program:

docker run -v <path source dir>:/home/ballerina -it ballerina/ballerina-runtime:<tag> ballerina run <.bal(x) file>

eg:- Following command runs the demo.balx file in current directory.

docker run -v `pwd`:/home/ballerina -it ballerina/ballerina-runtime:0.970.1 ballerina run demo.balx

• With Dockerfiles: Use ballerina/ballerina-runtime as a base for your own Dockerfiles. For instance, something along the lines of the following will run your ballerina program:

FROM ballerina/ballerina-runtime:0.970.1

COPY hello_world_docker.bal /home/ballerina 

EXPOSE  9090

CMD ballerina run hello_world_docker.balx

• With @docker and @kubernetes annotations: This image is used as the base image when building Dockerfile from Docker and Kubernetes annotations in ballerina files. Refer samples for more information.
  • Docker Annotation Samples⁠
  • Kubernetes Annotation Samples⁠

⁠License

View Ballerina license⁠ information for the software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).

As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.