To launch the registry server

It will be launched at http://localhost:3000. You can check it at http://localhost:3000/health.

Because Terraform CLI works with only HTTPS server, you should set up HTTPS in front of the registry server.

If you want to test it at local, you need a tool which provides HTTPS like ngrok.

Environment variables:

• CITIZEN_DATABASE_TYPE: Backend provider for registry metadata. Set to mysql, mongodb or sqlite.

• CITIZEN_DATABASE_URL: The URL of the database. protocol//username:password@hosts:port/database?options

• CITIZEN_STORAGE: Storage type to store module files. You can use file, s3 or gcs type.

  • s3 is for AWS S3.

  • gcs is for Google Cloud Storage.

• CITIZEN_STORAGE_PATH: A directory to save module files only if CITIZEN_STORAGE is file (absolute/relative path can be used).

• CITIZEN_STORAGE_BUCKET: A S3 bucket to save module files only if CITIZEN_STORAGE is s3 or gcs.(And AWS credentials required.)

If you want to use GCS as a storage, you need to authenticate to Google Cloud services.

To migrate the database, you can use citizen generate-migration command. The command will generate migration files which are schema.prisma and migrations/ directory. Because we use prisma to handle databases, you need to install prisma CLI.

Then, Set CITIZEN_DATABASE_TYPE and CITIZEN_DATABASE_URL envorinment variables and Run prisma migrate deploy for Sqlite. For MongoDB, migration is not required.

Since official Terraform Module Registry is integrated with GitHub, users can publish terraform modules if they just push it on GitHub.

Citizen provides a special command to publish a module onto citizen registry server instead integrating GitHub.

In a module directory, you can publish your terraform module via a command below:

You should set CITIZEN_ADDR as citizen registry server address which you will publish your modules to. e.g. https://registry.example.com.

If you have ALB module in ./alb directory, and your registry server is launched at https://registry.example.com, you run below command in ./alb directory to publish ALB module.

Then, you can define it in your terraform file like this:

Citizen provides a special command to publish providers onto citizen.

• -g, --gpg-key <gpgkey>: GPG key to sign your SHA256SUMS.

  • You need to publish your provider with your GPG public key to terraform registry. Otherwise, terraform will refuse to install providers. Terraform official resistry manage partners' public keys, but, each provider version has own public key and signature in citizen registry.

You must first build and package, citizen expects following files in the provider location:

• <namespace>-<type>_<version>_<os>_<arch>.zip (one per os/arch combination)

Where <namespace> and <type> is a name of the provider and <version> is a provider version in the MAJOR.MINOR.PATCH version format.

Citizen will generate a SHA256SUMS file and a GPG signature file automatically for you: Following files will be generated in your directory during publising provider. So, You don’t need prepare theses files.

• <namespace>-<type>_<version>_SHA256SUMS

• <namespace>-<type>_<version>_SHA256SUMS.sig

Therefore, shasum and gpg commands should be available in your machine.

In a provider directory, you can publish your terraform provider via a command below:

[protocols] is comma separated Terraform provider API versions, with MAJOR.MINOR.

You should set CITIZEN_ADDR as citizen registry server address which you will publish your modules to. e.g. https://registry.example.com.

If you have ALB provider in ./utilities directory, and your registry server is launched at https://registry.example.com, you run below command in ./utilities directory to publish utilities provider.

Then, you can define it in your terraform file like this:

Set at least a storage path and the s3 bucket name variables for the tests to succeed. You need to be able to access the bucket, so you probably want to have an active aws or aws-vault profile.

Run mongodb as replica set first like:

Run MySQL with docker

Run the tests:

Run the tests with the environment variables prefixed:

It will generate prisma clients for databases.

Under dist/, citizen binaries for linux, darwin(amd64/arm64) and windows made.