This repository holds the default set of collections available for Kabanero. Each collection is pre-configured with popular open-source technologies to enable rapid development and deployment of quality microservice-based applications. Collections include a base container image and project templates, which act as a starting point for your application development, as well as Tekton pipelines for deploying your microservice to Kubernetes.
To find out more about Kabanero, check out kabanero.io.
The Working with Kabanero Collections guide provides information on the following topics:
In addition to the "Working with Kabanero Collections guide" the following section provides information about Testing prior to creating a production release
Before creating a final production release for use with your Kabanero installation, you may wish to create a test release on a test GIT repository.
kubectl apply -f sample.yaml
This will update the collections and pipelines in your environment. New collections and pipeline should get activated as a result of this step.
[Optional] Publish built images to an image registry
If building locally you may want to publish the built images to an image registry. If using Travis to build your release then these should be pushed as part of the Travis build.
In order to push these images correctly there are some environment variables that will need to be setup:
# Publish images to image registry
export IMAGE_REGISTRY_PUBLISH=true
# Credentials for publishing images:
export IMAGE_REGISTRY=<registry>
export IMAGE_REGISTRY_USERNAME=<registry_username>
export IMAGE_REGISTRY_PASSWORD=<registry_password>
Once these environment variable have been set you can publish the images by running a script. From the base directory, run the release script. For example:
. ./ci/release.sh
This will copy files from the ./ci/assets directory to a ./ci/release directory and will then push the built images to the specified image registry.
[Optional] Create a production Git Release
If building locally and not using Travis, you will need to create a release on a production GIT repository.
e.g. https://github.com/kabanero-io/collections/releases/download/v0.2.0.beta2/kabanero-index.yaml .
When using Github Enterprise to store collections you may need an alternative mechanism for hosting your release artifacts due to authentication requirements. See Hosting your collections using NGINX, which describes the steps needed to build your collections and deploy an NGINX server to host them into your Kabanero instance.
If you have a question that you can't find an answer to, we would also like to hear about that too. You can reach out to the community for assistance on the Kabanero Slack channel.