Fediversity/launch/.terraform/modules/pixelfed.deploy/aws_image_nixos/README.md

AWS Collection of NixOS AMIs

This terraform module provides links to official NixOS AMIs on AWS. The AMIs are released by the NixOS project.

Since image names are unique, only one instance per version of the module is supported.

Example

provider "aws" {
  region = "eu-west-1"
}

module "nixos_image_1903" {
  source  = "path/to/aws_image_nixos"
  release = "19.03"
}

resource "aws_instance" "example" {
  ami           = module.nixos_image_1903.ami
  instance_type = "t2.micro"

  ...
}

New NixOS releases

Run the ./update-url-map script to fetch new image releases.

Inputs

Name	Description	Type	Default	Required
region	The region to use. If not provided, current provider's region will be used.	string	``	no
release	The NixOS version to use. For example, 18.09	string	latest	no
type	The type of the AMI to use -- hvm-ebs, pv-ebs, or pv-s3.	string	hvm-ebs	no
url_map	A map of release series to actual releases	map	<map>	no

Outputs

Name	Description
ami	NixOS AMI on AWS