mirror of
https://github.com/mulgadc/spinifex.git
synced 2026-10-19 19:01:42 +00:00
Julian Sommer
109 lines
2.3 KiB
Markdown
109 lines
2.3 KiB
Markdown
---
|
|
title: "Moving an AWS Workload to Mulga"
|
|
description: "Migrate existing AWS workloads to Spinifex using compatible APIs, SDKs, and Terraform."
|
|
category: "Migration"
|
|
tags:
|
|
- migration
|
|
- aws
|
|
- terraform
|
|
resources:
|
|
- title: "Spinifex Repository"
|
|
url: "https://github.com/mulgadc/spinifex"
|
|
- title: "AWS CLI Reference"
|
|
url: "https://docs.aws.amazon.com/cli/latest/reference/"
|
|
- title: "Terraform AWS Provider"
|
|
url: "https://registry.terraform.io/providers/hashicorp/aws/latest"
|
|
---
|
|
|
|
# Moving an AWS Workload to Mulga
|
|
|
|
> Migrate existing AWS workloads to Spinifex using compatible APIs, SDKs, and Terraform.
|
|
|
|
## Table of Contents
|
|
|
|
- [Overview](#overview)
|
|
- [Instructions](#instructions)
|
|
- [Troubleshooting](#troubleshooting)
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
Spinifex provides drop-in compatibility with AWS APIs, making it possible to migrate existing workloads with minimal changes.
|
|
|
|
**Supported Services:** VPC, EC2, EBS, S3, IAM
|
|
|
|
**Compatible Tools:** AWS CLI, AWS SDKs, Terraform, any S3-compatible client
|
|
|
|
## Instructions
|
|
|
|
## Prerequisites
|
|
|
|
Ensure the AWS profile is set:
|
|
|
|
```bash
|
|
export AWS_PROFILE=spinifex
|
|
```
|
|
|
|
## Configure AWS CLI
|
|
|
|
```bash
|
|
aws ec2 describe-instances
|
|
aws s3 ls
|
|
```
|
|
|
|
## Terraform
|
|
|
|
```hcl
|
|
provider "aws" {
|
|
region = "ap-southeast-2"
|
|
access_key = "your-spinifex-access-key"
|
|
secret_key = "your-spinifex-secret-key"
|
|
|
|
endpoints {
|
|
ec2 = "https://localhost:9999"
|
|
s3 = "https://localhost:8443"
|
|
}
|
|
|
|
skip_credentials_validation = true
|
|
skip_metadata_api_check = true
|
|
skip_requesting_account_id = true
|
|
}
|
|
```
|
|
|
|
## Hybrid S3 Sync
|
|
|
|
```bash
|
|
aws s3 sync s3://local-bucket/ s3://cloud-bucket/ --source-region spinifex --region us-east-1
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
## Terraform Provider Errors
|
|
|
|
Ensure all three skip flags are set in your provider configuration:
|
|
|
|
```hcl
|
|
skip_credentials_validation = true
|
|
skip_metadata_api_check = true
|
|
skip_requesting_account_id = true
|
|
```
|
|
|
|
Without these, Terraform will try to validate credentials and metadata against real AWS endpoints.
|
|
|
|
## S3 Signature Errors
|
|
|
|
Spinifex uses AWS Signature V4. Ensure your AWS CLI is version 2.0 or higher:
|
|
|
|
```bash
|
|
aws --version
|
|
```
|
|
|
|
If using an older version, upgrade:
|
|
|
|
```bash
|
|
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
|
|
unzip awscliv2.zip
|
|
sudo ./aws/install --update
|
|
```
|