https://github.com/redhat-developer/mapt
Multi Architecture Provisioning Tool
https://github.com/redhat-developer/mapt
airgap aks arm64 aws azure custom fedora gh-runner k8s macos proxy rhel spot-price spot-prices vpn windows-desktop windows-server x86-64
Last synced: 3 months ago
JSON representation
Multi Architecture Provisioning Tool
- Host: GitHub
- URL: https://github.com/redhat-developer/mapt
- Owner: redhat-developer
- License: apache-2.0
- Created: 2022-09-23T22:56:42.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-25T14:13:45.000Z (3 months ago)
- Last Synced: 2025-03-30T14:35:43.580Z (3 months ago)
- Topics: airgap, aks, arm64, aws, azure, custom, fedora, gh-runner, k8s, macos, proxy, rhel, spot-price, spot-prices, vpn, windows-desktop, windows-server, x86-64
- Language: Go
- Homepage:
- Size: 31.7 MB
- Stars: 11
- Watchers: 7
- Forks: 10
- Open Issues: 64
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# mapt (Multi Architecture Provisionig Tool)
Mapt is a swiss army knife for provisioning environments, it could be used across multiple CI/CD systems:
* Github Actions: It is possible to spin the target machines as self hosted runners on your github repo to make use of them within actions.
* Tekton: Each target environemnt offered has its own tekton task spec which could be used as a extenal spec on tekton (with git resolver or even as a bunde)
* Run from anywhere: mapt funcionallity is offered as an OCI image, as so it allows to create environment from almost everywhere as long as you have a container runtime.
Also it includes out of the box some optimizations around provisioning:
* Spot price option which allows to find the best option for the target machine on any location across the target provider.
* Implement optimization around boot time to reduce the amount of time required to spin the machines (i.e. pre created snapshots or change root volumes)
About the target environments offered it is not limited to a single machine or service but it takes care of the full infra allowing to requrest complex topologies:
* Airgap
* Proxy (Coming...)
* VPN emulation (Coming... )
* Domain Controller integration (Coming... )
## Supported environments
### Virtual Machines
| Platform | Archs | Provider | Type | Information | Tekton
| -------------- | ------------- | ------------- | ------------- | ---------------------------- | --------------------------------------------
| Mac | x86, M1, M2 | AWS | Baremetal | [info](docs/aws/mac.md) | [task](tkn/infra-aws-mac.yaml)
| Windows Server | x86 | AWS | Baremetal | [info](docs/aws/windows.md) | [task](tkn/infra-aws-windows-server.yaml)
| Windows Desktop| x86 | Azure | Virtualized | [info](docs/azure/windows.md)| [task](tkn/infra-azure-windows-desktop.yaml)
| RHEL | x86, arm64 | AWS | Customizable | [info](docs/aws/rhel.md) | [task](tkn/infra-aws-rhel.yaml)
| RHEL | x86, arm64 | Azure | Virtualized | [info](docs/azure/rhel.md) | [task](tkn/infra-azure-rhel.yaml)
| Fedora | x86, arm64 | AWS | Customizable | [info](docs/aws/fedora.md) | [task](tkn/infra-aws-fedora.yaml)
| Fedora | x86, arm64 | Azure | Customizable | [info](docs/azure/fedora.md) | [task](tkn/infra-azure-fedora.yaml)
| Ubuntu | x86 | Azure | Virtualized | [info](docs/azure/ubuntu.md) | -
### Services
| Service | Provider | Information | Tekton
| -------------- | ------------- | ------------- | ---------------------------- |
| AKS | Azure | [info](docs/azure/aks.md) | [task](tkn/infra-azure-aks.yaml)
## CI/CD integrations
### Github Self hosted runner
`mapt` can setup a deployed machine as a Self Hosted runner on most of the Platform and Provider combinations
it supports.
Use the following flags with `mapt create` command:
```
--install-ghactions-runner Install and setup Github Actions runner in the instance
--ghactions-runner-name Name for the Github Actions Runner
--ghactions-runner-repo Full URL of the repository where the Github Actions Runner should be registered
--ghactions-runner-token Token needed for registering the Github Actions Runner token
```