Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/GuanceCloud/iacker

The Infrastructure as Code Provider Development Framework
https://github.com/GuanceCloud/iacker

crossplane guance hacktoberfest hacktoberfest2023 kubevela terraform

Last synced: 3 months ago
JSON representation

The Infrastructure as Code Provider Development Framework

Host: GitHub
URL: https://github.com/GuanceCloud/iacker
Owner: GuanceCloud
License: mit
Created: 2023-09-26T08:08:17.000Z (about 1 year ago)
Default Branch: main
Last Pushed: 2023-12-02T09:57:24.000Z (12 months ago)
Last Synced: 2024-06-10T13:43:54.424Z (5 months ago)
Topics: crossplane, guance, hacktoberfest, hacktoberfest2023, kubevela, terraform
Language: Go
Homepage:
Size: 1.72 MB
Stars: 2
Watchers: 6
Forks: 3
Open Issues: 9
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        # Iacker

**NOTE**: This project is a work in progress. DON'T USE IT TO PRODUCTION.

[![Go Report Card](https://goreportcard.com/badge/github.com/GuanceCloud/iacker)](https://goreportcard.com/report/github.com/GuanceCloud/iacker)

[![GoDoc](https://godoc.org/github.com/GuanceCloud/iacker?status.svg)](https://godoc.org/github.com/GuanceCloud/iacker)

[![License](https://img.shields.io/github/license/GuanceCloud/iacker.svg)](https://www.apache.org/licenses/LICENSE-2.0)

Iacker is a development framework to help cloud-native developers hugging with the infrastructure as a code's world.

The goal is to implement the open features for service providers.

* **Open API**: Expose [Cloud Control](https://aws.amazon.com/cloudcontrolapi/) and [GraphQL](https://graphql.org/) API to the developer.

* **Open Provider**: Auto-generate provider code for [Terraform](https://www.terraform.io), [Pulumi](https://www.pulumi.com), [CDK](https://developer.hashicorp.com/terraform/cdktf), [KubeVela](https://kubevela.io), [Crossplane,](https://www.crossplane.io) etc.

* **Open Integration**: Create libraries for [Cobra](https://github.com/spf13/cobra), [Apollo,](https://www.apollographql.com) and software development kits for various languages.

## Introduction

### Features

* **Model-driven**: Define the resource schema by [CUE](https://cuelang.org/) and unified specification.

* **Developer-first**: All workflows in code, collaborate with others with [GitOps](https://www.weave.works/technologies/gitops/) workflow.

* **Generator-oriented**: Build your own generator using the unified specification. Many popular IaC tools are provided.

### Real-world example

> We used it to create the [Terraform Provider for Guance Cloud](https://github.com/GuanceCloud/terraform-provider-guance) and other related services and tools.

![Logo](./artwork/banner-ins.jpeg)

## Roadmap

All the features are described in the `proposals` folder. It is inspired by the [GRFC Template](https://github.com/grpc/proposal/blob/master/GRFC-TEMPLATE.md) used in Google. You can find the implementation status in the table below.

The proposal workflow is described in the [Guance Cloud Proposal Governance Guidelines](https://github.com/GuanceCloud/community/tree/main/proposals).

### Architecture

Architecture defines the basic concepts and principles of *Iacker* architecture.

| #    | Title                         | How-tos |

| ---- | ----------------------------- | -------------- |

| A001 | [API as Code in *Iacker*](./proposals/A001-api-as-code-overview.md)   | How *Iacker* governance our API |

| A002 | [Resource Management Specification](./proposals/A002-resource-management-specification.md) | How to define a new cloud resource |

| A003 | [Generator Framework](./proposals/A003-generator-framework.md) | How to build developer tools by *Iacker* |

| A004 | Resource Management Server | How to develop once, run as multiple protocols |

### Protocols

At *Iacker*, we use a unified resource management framework to expose various protocols for different use cases.

Protocols describe the protocols used in *Iacker*. Please follow the protocol specification (coming soon) to add a new protocol.

| #    | Title                         | How-tos |

| ---- | ----------------------------- | -------------- |

| P001 | Cloud Control API | Cloud Control API and the implementations |

### Developer Tools

Developer tools are the core of developer experience infrastructure (DXI). It provides tools to help developers build, test, and deploy their API callings.

| #    | Title                         | How-tos |

| ---- | ----------------------------- | -------------- |

| T001 | [Resource Explorer](./proposals/T001-resource-explorer.md) | How to discover and interact with cloud resource |

| T002 | Terraform Provider | How to build the engineering capability for X as Code world |

## Developer Guide

See the [hack](./hack) folder to understand how to build this project.

## Contributing

We welcome contributions to *Iacker*. Please see the [Contributing Guidelines](https://guance.io/contribution-guide/) for more information.