Warg Registry Server

⚠️ This is prototype quality code at this time. ⚠️

Running the server

The registry server can be started with either in-memory or PostgreSQL storage.

In-memory storage

With in-memory storage, the server will store all data in-memory and the data will be lost when the server is stopped.

To start the server, provide the WARG_OPERATOR_KEY environment variable, which is used to sign the entries in the server's operator log:

Also, provide the WARG_NAMESPACE environment variable to define the initial namespace for package publishing.

$ WARG_NAMESPACE=example WARG_OPERATOR_KEY="ecdsa-p256:I+UlDo0HxyBBFeelhPPWmD+LnklOpqZDkrFP5VduASk=" cargo run -- --content-dir content
2023-04-18T23:48:52.149746Z  INFO warg_server::services::core: initializing core service
2023-04-18T23:48:52.170199Z  INFO warg_server::services::core: core service is running
2023-04-18T23:48:52.170233Z  INFO warg_server: listening on 0.0.0.0:8090

PostgreSQL storage

With PostgreSQL storage, the server will store all data in a PostgreSQL database.

Support for PostgreSQL storage is behind the postgres compilation feature flag.

The easiest way to start a PostgreSQL server is with Docker:

docker run -d --name postgres -e POSTGRES_PASSWORD=password -v /tmp/data:/var/lib/postgresql/data -p 5432:5432 postgres

With the above command, data will be stored in /tmp/data on the host machine.

To set up the database, install diesel-cli:

cargo install diesel_cli

And run the setup with:

diesel database setup --database-url postgres://postgres:password@localhost/registry

Here, registry is the database name that will be created.

To start the registry server, provide both the WARG_OPERATOR_KEY and WARG_DATABASE_URL environment variables:

WARG_NAMESPACE=example WARG_DATABASE_URL=postgres://postgres:password@localhost/registry WARG_OPERATOR_KEY="ecdsa-p256:I+UlDo0HxyBBFeelhPPWmD+LnklOpqZDkrFP5VduASk=" cargo run -p warg-server --features postgres -- --content-dir content --data-store postgres

The --data-store postgres flag starts the server with PostgreSQL data storage.

The server may now be restarted and will continue to use the same database.