KrakenD Enterprise Installation Guide

Document updated on Feb 2, 2020

KrakenD Enterprise is delivered in several formats, including Docker, Linux packages (deb, rpm) and generic installation options.

Docker

If you are already familiar with Docker, the easiest way to get started is by pulling our KrakenD image from Azure or AWS. As the repositories are private, you need to provide the credentials we sent.

From Amazon ECR

To pull our Docker image from AWS, you need to:

1. Install the AWS CLI if you don’t have it yet.
2. Add the credentials we provided
3. Login to ECR
4. Pull the container
5. Push it to your registry

Save the credentials

The AWS credentials that you received need to be stored under ~/.aws/credentials. The file might looks like this (fake credentials below):

[default]
aws_access_key_id = AKIAQYWA47SCCDSQLWAN
aws_secret_access_key = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

If you already have credentials, add another named profile.

Login to ECR

Now you are ready to login into ECR and download the content. Depending on which version of the AWS CLI you have installed you might need one of these two commands:

AWS CLI v2:

$aws ecr get-login-password --region us-east-1 | \
    	docker login --username AWS --password-stdin \
    	052351007912.dkr.ecr.us-east-1.amazonaws.com

AWS CLI v1:

$$(aws ecr get-login --region us-east-1 --no-include-email)

Pull the image and push to your registry

$docker pull krakend/krakend-ee:1.3.0

If you have a corporate Docker registry you might want to push the image locally:

$docker tag krakend/krakend-ee:1.3.0 youregistry.com/krakend-ee:1.3.0
docker push youregistry.com/krakend-ee:1.3.0

From Azure Container Registry

To pull pur Docker image from Azure, you need to:

1. Install Azure CLI
2. Login to Azure with az login
3. When the browser opens, use the credentials you have received from KrakenD
4. az acr login --name krakend
5. docker pull krakend.azurecr.io/krakend-ee:1.3.0

After these commands you will have in your local computer the krakend enterprise container. You can push it to your own ACR or use it locally.

Linux installation (non-Docker)

The installation process requires going through these steps:

1. Download de certificate chain
2. Setup the KrakenD repository
3. Install KrakenD
4. Start the KrakenD service

Download the certificate

The first step to all Linux flavours is to download the certicate chain from our repository:

$aws s3 cp s3://download.enterprise.krakend.io/krakend-ca-chain.pem /etc/krakend/krakend-ca-chain.pem

AWS-CLI needed. The credentials to access this bucket are provided in the welcoming email.

Debian and Ubuntu (apt)

Create a config file in /etc/apt/apt.conf.d/99krakend with this content:

Acquire::https::repo.enterprise.krakend.io {
    CaInfo "/etc/krakend/krakend-ca-chain.pem";
    SslCert "/etc/krakend/LICENSE";
    SslKey  "/etc/krakend/LICENSE.key";
};

Make sure the three files referenced above are placed in /etc/krakend.

Run the following commands:

$apt-key adv --keyserver keyserver.ubuntu.com --recv 5DE6FD698AD6FDD2
echo "deb https://repo.enterprise.krakend.io/apt stable main" | tee /etc/apt/sources.list.d/krakend-ee.list
apt-get update
apt-get install -y krakend-ee

Now the krakend command is available in the system.

KrakenD should run on old systems too, at least from Debian 8 and Ubuntu 16.x

CentOS and Redhat (yum)

The RPM file can be downloaded from here:

aws s3 cp s3://download.enterprise.krakend.io/krakend-ee-repo-1.0-2.x86_64.rpm .

Make sure the LICENSE files LICENSE, and LICENSE.key are placed in /etc/krakend.

Then install and start the latest version of KrakenD with:

$rpm -Uvh krakend-ee-repo-1.0-2.x86_64.rpm
yum install krakend-ee
systemctl start krakend-ee

Generic linux install (via tar.gz)

You can also download a tar.gz and decompress it anywhere. Instructions to check the SHA and PGP signature here

$aws s3 cp s3://download.enterprise.krakend.io/bin/krakend-ee_1.2.1_amd64.tar.gz .

aws s3 cp s3://download.enterprise.krakend.io/bin/krakend-ee_1.2.1_amd64.tar.gz.sha256 .
aws s3 cp s3://download.enterprise.krakend.io/bin/krakend-ee_1.2.1_amd64.tar.gz.asc .