Skip to content

Latest commit

 

History

History
89 lines (65 loc) · 5.38 KB

readme.md

File metadata and controls

89 lines (65 loc) · 5.38 KB
Raw

TechBD Infrastructure as Code (IaC) Home

Welcome to the Technology By Design (TechBD) Infrastructure as Code (IaC) repository. Infrastructure Prime is the monolithic repository (monorepo) for all IaC deployments. This repository is dedicated to managing and orchestrating the infrastructure setup across various platforms including Docker, AWS, Azure, and Oracle. Our goal is to streamline development processes and ensure consistency across all environments.

Purpose

The TechBD IaC repository serves as the central hub for TechBD's infrastructure coding efforts. By using this monorepo structure, we aim to:

  • Centralize Management: Single repository for all infrastructure configurations makes it easier to manage permissions, dependencies, and updates.
  • Improve Collaboration: Teams can work together more effectively with shared contexts and easier code reviews.
  • Consistency and Standardization: Ensure uniform standards across all infrastructure deployments, reducing the chances of discrepancies.
  • Enhanced Security: Simplify security protocols by concentrating all infrastructure code into a single repository.

Continuous Integration and Deployment

Release

CloudWatch Dashboards

Repository Structure

The repository is organized by technology stack and deployment environments as follows:

infrastructure-prime/
│
├── common/              # Common configurations and scripts shared across platforms
│
├── docker/              # Docker configurations and environments
│   └── sandbox/         # Sandbox environment for Docker-based experiments
│
├── aws/                 # AWS (Amazon Web Services) infrastructure
│   ├── common/  # Reusable AWS components for techbd
│   ├── synthetic.sftp.techbd.org/  # SFTP server setup on AWS (production)
│   ├── synthetic.api.techbd.org/  # HTTP server setup on AWS (production)
│   ├── synthetic.fhir.api.techbd.org/  # FHIR server setup on AWS (production)
│   ├── synthetic.sftp.devl.techbd.org/  # SFTP server setup on AWS (development)
│   ├── synthetic.api.devl.techbd.org/  # HTTP server setup on AWS (development)
│   ├── synthetic.fhir.api.devl.techbd.org/  # FHIR server setup on AWS (development)
│   └── <whatever other deployments>/  # Other AWS-based deployments using CDK
│
├── azure/               # Microsoft Azure infrastructure
│   └── <whatever other deployments>/  # Various deployments on Azure
│
├── oracle/              # Oracle Cloud infrastructure
│   ├── <whatever other deployments>/  # General Oracle Cloud deployments
│   └── virtualbox/      # VirtualBox environments managed in any local or hosted VMs
│       └── sandbox/     # Sandbox environment for VirtualBox setups

Directory Descriptions

  • Common: Contains scripts, templates, and configurations that are used across multiple platforms to ensure consistency and reduce duplication.
  • Docker: Contains Dockerfiles and related scripts for creating and managing Docker containers, particularly for development and testing environments.
  • AWS: Houses templates and scripts for deploying services on AWS using the Cloud Development Kit (CDK). This includes specific deployments like synthetic SFTP servers as well as templates for scalable cloud architectures.
  • Azure: Includes configurations and deployment scripts for services hosted on Microsoft Azure, covering a range of applications from web services to database configurations.
  • Oracle: Contains Oracle Cloud-specific deployments and configurations, including setups for VirtualBox that facilitate isolated environments for testing and development within Oracle Cloud.

Getting Started

To get started with using or contributing to the TechBD IaC repository, please ensure you have the following prerequisites:

  1. Access to the TechBD GitHub account.
  2. Proper setup of necessary tools and access credentials for Docker, AWS, Azure, and Oracle Cloud.
  3. Familiarity with Git and GitHub workflows.

Clone this repository using:

git clone https://github.com/TechBD/infrastructure-prime.git

Contribution Guidelines

Contributions to the TechBD IaC repo are welcome! Please follow our contribution guidelines:

  • Code Reviews: All commits should be made via pull requests and reviewed by at least one other team member.
  • Style Guide: Adhere to the coding styles and guidelines provided in the docs/ directory.
  • Issue Tracking: Use GitHub Issues to track tasks and bugs.
  • Branch Naming: Follow the branch naming convention feature/<feature>, bugfix/<issue>, or hotfix/<issue> for clarity and organization.

License

This project is licensed under the MIT License.

For more information or to report an issue, please contact the TechBD infrastructure team at [email protected].

Thank you for being part of our project!