Public | Automated Build

Last pushed: a year ago
Short Description
Lektor site generator implemented as an S2I builder.
Full Description

Lektor Site Generator

This repository implements a Lektor site generator and hosting service. It is implemented as a Source-to-Image (S2I) builder and can be used to generate a standalone Docker-formatted image which you can run with any container runtime supporting Docker-formatted images. Alternatively the S2I builder can be used in conjunction with OpenShift to handle both the build and deployment of the generated Lektor formatted site.

Integration With OpenShift

To use this with OpenShift, it is a simple matter of creating a new application within OpenShift, pointing the S2I builder at the Git repository containing your Lektor document source.

As an example, to build and host the the Lektor site, you only need run:

oc new-app getwarped/s2i-lektor-server:2.3~ --name lektor-site

oc expose svc/lektor-site

To have any changes to your document source automatically redeployed when changes are pushed back up to your Git repository, you can use the web hooks integration of OpenShift to create a link from your Git repository hosting service back to OpenShift.

To make it easier to deploy a Lektor site, a template for OpenShift is also included. This can be loaded into your project using:

oc create -f

Once loaded, select the lektor-server template from the web console when wanting to add a new site to the project.

The template details are:

Name:        lektor-server
Description:    Lektor Server
Annotations:    tags=instant-app,lektor

    Name:        APPLICATION_NAME
    Description:    The name of the application.
    Required:        true
    Value:        lektor-server

    Name:        SOURCE_REPOSITORY
    Description:    Git repository for source.
    Required:        true
    Value:        <none>

    Name:        SOURCE_DIRECTORY
    Description:    Sub-directory of repository for source files.
    Required:        false
    Value:        <none>

    Name:        DOCUMENT_ROOT
    Description:    Sub-directory of source directory for documents.
    Required:        false
    Value:        <none>

    Name:        BUILD_MEMORY_LIMIT
    Description:    Build time memory limit.
    Required:        true
    Value:        512Mi

    ImageStream        ${APPLICATION_NAME}
    ImageStream        ${APPLICATION_NAME}-s2i
    DeploymentConfig    ${APPLICATION_NAME}
    Service        ${APPLICATION_NAME}
    Route        ${APPLICATION_NAME}

The APPLICATION_NAME and SOURCE_REPOSITORY must be specified. Override the BUILD_MEMORY_LIMIT and set it to a higher memory value if the lektor application keeps getting killed when processing the site data.

Standalone Docker Images

To create a standalone Docker-formatted image, you need to install the s2i program from the Source-to-Image (S2I) project locally. Once you have this installed, you would run within your Git repository:

s2i build . getwarped/s2i-lektor-server:2.3 mylektorsite

In this case this will create a Docker-formatted image called mylektorsite. You can then run the image using:

docker run --rm -p 8080:8080 mylektorsite
Docker Pull Command
Source Repository