flamingo command - github.com/tmrts/flamingo

README ¶

Flamingo

Flamingo is a lightweight contextualization tool that aims to handle initialization of cloud instances.

It is meant to be a replacement for cloud-init in Atomic Host, a lightweight operating system designed to run applications in Docker containers with orchestration capabilities (Kubernetes). It has 3 different flavors; Fedora, RHEL, and CentOS.

For more details please check Introducing Flamingo

Goals

The aim of this project is to create a fast, extensible, documented tool to use

Why not use cloud-init?

In order for an image to be built with cloud-init as its contextualization tool, it needs to contain the python interpreter, it's dependencies and the dependencies of cloud-init. It fattens up the image and increases complexity for the distributions.
Due to the dynamic nature of scripting languages they are slow. In an I/O boud application this is not a big problem however initializing VM images, is different.
The documentation is lacking at best. The tests are inadequate and it is a big chunk of initialization scripts. Making it hard to work with cloud-init as a developer and maintainer.

Solution

Golang excels at building big applications (e.g. distributed computing). It provides the necessary tooling for the job. It doesn't have long dependency chains like interpreted languages and it is fast.
Flamingo will essentially be a single binary coupled with all of its dependencies. In addition, cloud images will be smaller as well.
Testability, Documentation and Extensibility is heavily emphasized in Flamingo.

Discussions

If you'd like to contribute, learn more, or share your opinions please feel free to open an issue, mail to centos-devel, atomic, user-list or come to #atomic and #centos-devel irc channels to have a chat.

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

flamingo.go

Directories ¶

Path	Synopsis
Godeps
_workspace/src/github.com/jtolds/gls Package gls implements goroutine-local storage.	Package gls implements goroutine-local storage.
_workspace/src/github.com/smartystreets/assertions Package assertions contains the implementations for all assertions which are referenced in goconvey's `convey` package (github.com/smartystreets/goconvey/convey) for use with the So(...) method.	Package assertions contains the implementations for all assertions which are referenced in goconvey's `convey` package (github.com/smartystreets/goconvey/convey) for use with the So(...) method.
_workspace/src/github.com/smartystreets/assertions/internal/oglematchers Package oglematchers provides a set of matchers useful in a testing or mocking framework.	Package oglematchers provides a set of matchers useful in a testing or mocking framework.
_workspace/src/github.com/smartystreets/assertions/internal/oglemock
_workspace/src/github.com/smartystreets/assertions/internal/oglemock/createmock createmock is used to generate source code for mock versions of interfaces from installed packages.	createmock is used to generate source code for mock versions of interfaces from installed packages.
_workspace/src/github.com/smartystreets/assertions/internal/oglemock/generate Package generate implements code generation for mock classes.	Package generate implements code generation for mock classes.
_workspace/src/github.com/smartystreets/assertions/internal/oglemock/generate/test_cases
_workspace/src/github.com/smartystreets/assertions/internal/oglemock/generate/test_cases/complicated_pkg Package complicated_pkg contains an interface with lots of interesting cases, for use in integration testing.	Package complicated_pkg contains an interface with lots of interesting cases, for use in integration testing.
_workspace/src/github.com/smartystreets/assertions/internal/oglemock/generate/test_cases/renamed_pkg A package that calls itself something different than its package path would have you believe.	A package that calls itself something different than its package path would have you believe.
_workspace/src/github.com/smartystreets/assertions/internal/oglemock/sample/mock_io
_workspace/src/github.com/smartystreets/assertions/internal/ogletest Package ogletest provides a framework for writing expressive unit tests.	Package ogletest provides a framework for writing expressive unit tests.
_workspace/src/github.com/smartystreets/assertions/internal/ogletest/srcutil Functions for working with source code.	Functions for working with source code.
_workspace/src/github.com/smartystreets/assertions/internal/ogletest/test_cases
_workspace/src/github.com/smartystreets/assertions/internal/ogletest/test_cases/mock_image
_workspace/src/github.com/smartystreets/assertions/internal/reqtrace Package reqtrace contains a very simple request tracing framework.	Package reqtrace contains a very simple request tracing framework.
_workspace/src/github.com/smartystreets/assertions/should package should is simply a rewording of the assertion functions in the assertions package.	package should is simply a rewording of the assertion functions in the assertions package.
_workspace/src/github.com/smartystreets/goconvey/convey Package convey contains all of the public-facing entry points to this project.	Package convey contains all of the public-facing entry points to this project.
_workspace/src/github.com/smartystreets/goconvey/convey/gotest Package gotest contains internal functionality.	Package gotest contains internal functionality.
_workspace/src/github.com/smartystreets/goconvey/convey/reporting Package reporting contains internal functionality related to console reporting and output.	Package reporting contains internal functionality related to console reporting and output.
_workspace/src/gopkg.in/yaml.v2 Package yaml implements YAML support for the Go language.	Package yaml implements YAML support for the Go language.
pkg
context
datasrc Package datasrc contains the interface required for being a data source provider and the implementations for finding an available data source.	Package datasrc contains the interface required for being a data source provider and the implementations for finding an available data source.
datasrc/metadata
datasrc/provider Package provider contains the interface for a data source provider	Package provider contains the interface for a data source provider
datasrc/provider/configdrive Handling configuration data passed via Config-Drive disk images.	Handling configuration data passed via Config-Drive disk images.
datasrc/provider/ec2
datasrc/provider/gce
datasrc/provider/openstack
datasrc/userdata
datasrc/userdata/cloudconfig Package cloudconfig validates and parses a cloud-config data file.	Package cloudconfig validates and parses a cloud-config data file.
distro Package distro contains the implementations of different operating systems to be used for contextualizing cloud instances.	Package distro contains the implementations of different operating systems to be used for contextualizing cloud instances.
file
flog Package flog implements logging utilities for flamingo	Package flog implements logging utilities for flamingo
request
sys
sys/firewall
sys/firewall/iptables
sys/identity
sys/initd initd provides interfaces and implementations for system initialization daemons	initd provides interfaces and implementations for system initialization daemons
sys/initd/systemd
sys/nss Package nss contains the gateway to query system Name Switch Service databases.	Package nss contains the gateway to query system Name Switch Service databases.
sys/ssh
util Package utils contains utility functions.	Package utils contains utility functions.
util/mock
util/rand
util/strutil Package strutil provides different string utilities	Package strutil provides different string utilities
util/testutil

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL