pkg

README

Deis Builder

Builder creates Docker images to be run elsewhere on the Deis platform. Builder itself also runs in a Docker container.

This Docker image is based on the official alpine:3.1 image.

Please add any issues you find with this software to the Deis Project.

Usage

Please consult the Makefile for current instructions on how to build, test, push, install, and start deis/builder.

Environment Variables

• DEIS_DEBUG enables verbose output if set
• ETCD_PORT sets the TCP port on which to connect to the local etcd daemon (default: 4001)
• ETCD_PATH sets the etcd directory where the builder announces its configuration (default: /deis/builder)
• ETCD_TTL sets the time-to-live before etcd purges a configuration value, in seconds (default: 10)
• PORT sets the TCP port on which the builder listens (default: 2222)

License

© 2015 Engine Yard, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Documentation

Overview

Package pkg provides common libraries for the Deis builder.

The Deis builder is responsible for building slugs and docker images for use in the Deis on the Deis PaaS platform.

Index

• Constants
• func RunBuilder(sshHostIP string, sshHostPort int, gitHomeDir string, ...) int

Constants

const (
	StatusOk = iota
	StatusLocalError
)

Return codes that will be sent to the shell.

Functions

func RunBuilder

func RunBuilder(sshHostIP string, sshHostPort int, gitHomeDir string, sshServerCircuit *sshd.Circuit, pushLock sshd.RepositoryLock) int

RunBuilder starts the Builder service.

The Builder service is responsible for setting up the local container environment and then listening for new builds. The main listening service is SSH. Builder listens for new Git commands and then sends those on to Git.

Run returns on of the Status* status code constants.