Skip to content

robert-portelli/devops-bootstrap

Repository files navigation

DevOps Bootstrap Template

Welcome to the DevOps Bootstrap Template, a starting point for creating modern, efficient, and opinionated infrastructure projects. This repository serves as a foundation that you can customize to suit your specific needs.

Table of Contents

  1. Purpose
  2. Features
  3. Getting Started
  4. Customization
  5. Example Workflows
  6. Contributing
  7. License

Purpose

This template aims to simplify and standardize the process of setting up DevOps practices by providing pre-configured workflows, tools, and automation scripts. It is designed for individuals or teams who want a reliable, scalable foundation for managing their infrastructure and workflows.


Features

  • Pre-configured GitHub Actions Workflows:
    • Automates CI/CD pipelines.
    • Includes branch protection rules.
  • Pre-commit Hook Integration:
    • Ensures code quality with linting and formatting.
  • Dynamic Configuration:
    • Adapts to changes in project structure and repository settings.
  • Documentation and Examples:
    • Clear instructions for customization and usage.
  • Extensibility:
    • Modular structure allows for adding new features and tools.

Getting Started

  1. Create a New Repository from the Template:

    • Click the Use this template button at the top of this repository.
    • Name your new repository and choose its visibility (public or private).
  2. Clone Your Repository Locally:

    git clone <your-repo-url>
    cd <your-repo-name>
  3. Install Pre-commit Hooks:

    pre-commit install
  4. Review and Customize:

    • Inspect the workflows in .github/workflows/ and other configuration files to tailor the template to your needs.

Customization

This template is designed to be flexible. You can customize it to suit your requirements by:

  • Editing GitHub Actions workflows in .github/workflows/.
  • Modifying the .pre-commit-config.yaml file to add or remove pre-commit hooks.
  • Adding additional directories, scripts, or documentation specific to your use case.

Example Workflows

Branch Protection Automation

Automates branch protection settings for default and non-default branches, ensuring code quality while maintaining flexibility for development branches.

CI/CD Pipeline

Includes workflows for testing, building, and deploying projects, leveraging GitHub Actions for seamless automation.


Contributing

Contributions are welcome! To contribute:

  1. Fork the repository.
  2. Create a new feature branch:
    git checkout -b feature/your-feature
  3. Commit your changes:
    git commit -m "Add your feature"
  4. Push your branch and open a pull request:
    git push origin feature/your-feature

License

This repository is licensed under the MIT License. See the LICENSE file for details.


About

a template from which to create new projects

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published