Geodesic

Abstract

1. 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 that enables you to truly achieve SweetOps.

We recommend starting by using geodesic as a Docker base image (e.g. FROM cloudposse/geodesic:... pinned to a release and base OS) in your projects.

Geodesic is a robust Linux toolbox container, crafted to optimize DevOps workflows. This container comes loaded with essential dependencies for a DevOps toolchain. It's designed to bring consistency and boost efficiency across development environments. It achieves this without the need for installing additional software on your workstation. Think of Geodesic as a containerized parallel to Vagrant, offering similar functionality within a Docker container context.

2. Objective

🚀 Geodesic is a DevOps Linux Toolbox in Docker

This project demonstrates how Shell, Kubernetes, Terraform can be applied to a real-world Blockchain & Cloud Computing problem.

3. Key Features / Modules

• Unified Toolchain: By packaging all necessary DevOps tools and dependencies, Geodesic eliminates the "works on my machine" problem, ensuring toolchain uniformity across different machines.
• Consistent Environment: Geodesic guarantees that every developer operates in a uniform OS environment with consistent tool versions, sidestepping discrepancies that often arise in diverse development setups.
• Quick Start for New Developers: It streamlines the onboarding process for new team members, allowing them to bypass lengthy workstation configurations and dive straight into productivity.
• Cross-Platform Compatibility: With native support for Mac OSX, Linux, and Windows (via WSL), Geodesic extends its versatile toolchain to a wide range of operating systems, ensuring broad accessibility and functionality.
• Version Control for Tools: Geodesic facilitates easy versioning of tools for different environments, enabling repeatable setups and minimizing compatibility issues.
• Reusable Base Image for Toolboxes: Empower teams to create and maintain consistent toolbox images, ensuring a standardized development environment across the board.
• We have added preliminary support for "dark mode" terminals. Your terminal mode should be detected automatically,
• The GEODESIC_TF_PROMPT_ENABLED environment variable has been revived. Set it to true and when in a Terraform

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Linux / macOS terminal or WSL on Windows
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/cloudposse/geodesic.git
cd geodesic

1. Debian has a large selection of packages to choose from.
2. Cloud Posse also provides a large set of packages for installing common DevOps commands
3. Google Cloud provides a set of packages for working with GCP
4. OpenTofu provides a package for installing it, too.

docker run --rm cloudposse/geodesic:latest-debian init | bash

geodesic

RUN apt-get update && apt-get install -y <package-name>...

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add a CI/CD pipeline with GitHub Actions
• Deploy to a public test network or cloud free tier
• Add monitoring and cost alerts

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Why does this problem need a blockchain or cloud-native design?
2. Explain the smart contract / infrastructure components and how they interact.
3. How are gas costs or cloud costs kept under control?
4. How is the system secured (keys, IAM, access control)?
5. How would the solution scale to many more users?

9. Source Code & License

This project is developed by cloudposse and published on GitHub under the Apache License 2.0. Please follow the license terms and credit the original author when you use or modify this code.