Geodesic

Geodesic is the fastest way to get up and running with a rock solid, production grade cloud platform built entirely from Open Source technologies.

It’s a swiss army knife for creating and building consistent platforms to be shared across a team environment.

It easily versions staging environments in a repeatable manner that can be followed by any team member.

It's a way of doing things that allows companies to collaborate on infrastructure (~~snowflakes~~) and radically reduce Total Cost of Ownership.

It provides a fully customizable framework for defining and building cloud infrastructures backed by AWS. It couples best-of-breed technologies with engineering best-practices to equip organizations with the tooling that enables clusters to be spun up in record time without compromising security.

It's works natively with Mac OSX, Linux, and Windows 10 (WSL).

Open Source and licensed under the APACHE2.

Introduction

These days, the typical software application is distributed as a docker image and run as a container. Why should infrastructure be any different? Since everything we write is "Infrastructure as Code", we believe that it should be treated the same way. This is the "Geodesic Way". Use containers+envs instead of unconventional wrappers, complicated folder structures and symlink hacks. Geodesic is the container for all your infrastructure automation needs.

title: ABOUT(1) | Geodesic author:

Josh Myers date: July 2019

NAME

about - About the Geodesic Cloud Automation Shell

FEATURES

Secure - TLS/PKI, OAuth2, MFA Everywhere, remote access VPN, ultra secure bastion/jumphost with audit capabilities and slack notifications, IAM assumed roles, automatic key rotation, encryption at rest, and VPCs
Repeatable - 100% Infrastructure-as-Code with change automation and support for scriptable admin tasks in any language, including Terraform
Extensible - A framework where everything can be extended to work the way you want to
OpenSource - Permissive APACHE 2.0 license means no lock-in and no on-going license fees

TECHNOLOGIES

At its core, Geodesic is a framework for provisioning cloud infrastructure and the applications that sit on top of it. We leverage as many existing tools as possible to facilitate cloud fabrication and administration. We're like the connective tissue that sits between all of the components of a modern cloud.

atlantis - GitOps style operations by Pull Request. Ideal for terraform, helm and helmfile.
aws-vault for securely storing and accessing AWS credentials in an encrypted vault for the purpose of assuming IAM roles
aws-cli for interacting directly with the AWS APIs
chamber for managing secrets with AWS SSM+KMS and exposing them as environment variables
direnv for managing environment variables per project or globally
gomplate for template rendering configuration files using the GoLang template engine. Supports lots of local and remote datasources
goofys a high-performance Amazon S3 file system for mounting encrypted S3 buckets that store cluster configurations and secrets
terraform for provisioning miscellaneous resources on pretty much any cloud
tmate for remote terminal sharing with other engineers (pairing) and collaborative debugging

SEE MORE

Extensive documentation is provided on our Documentation Hub.

Contributing

Bug Reports & Feature Requests

Please use the issue tracker to report any bugs or file feature requests.

Copyright

License

See LICENSE for full details.

Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you 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

  https://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.

Contributors

Josh Myers

joshmyers/geodesic