Nebraska on Flatcar Container Linux

Deployment & Authorization

Mon, 01 Jan 0001 00:00:00 +0000

Nebraska uses either a noop authentication or OIDC to authenticate and authorize users.

Preparing the database for Nebraska

Nebraska uses the PostgreSQL database, and expects the used database to be set to the UTC timezone.

For a quick setup of PostgreSQL for Nebraska’s development, you can use the postgres container as follows:

Start Postgres:
- docker run --rm -d --name nebraska-postgres-dev -p 5432:5432 -e POSTGRES_PASSWORD=nebraska postgres
Create the database for Nebraska (by default it is nebraska):

Managing Flatcar updates

Mon, 01 Jan 0001 00:00:00 +0000

Once you have Nebraska up and running, a common use-case is to manage Flatcar Container Linux updates.

By default, your Flatcar Container Linux instances use the public servers to get updates, so you have to point them to your Nebraska deployment for it to manage their updates. The process for doing so is slightly different depending on whether you have existing machines or new ones.

New machines

For new machines, you can set up the updates server in their Container Linux Configuration. Here is a small example of how to do it:

Migrating to older version of Nebraska.

Mon, 01 Jan 0001 00:00:00 +0000

When migrating down to an older version of Nebraska one might have to rollback database migrations that were applied as a part of the release.

First get the migrations that were part of the version that you want to downgrade to using the following command.

git show :./backend/pkg/api/db/migrations | tail -n1

For example to find the migrations that were part of 2.4.0 release clone the Nebraska repo and run.

git show 2.4.0:../backend/pkg/api/db/migrations | tail -n1

Development

Mon, 01 Jan 0001 00:00:00 +0000

This section shows how to set up a development environment for Nebraska.

Nebraska needs a running PostgresSQL database. Apart from that, the recommended way to work on it, is to run the backend with the noop authentication backend, and the frontend in a “watch” mode (where it auto-refreshes when there are changes to the frontend).

Preparing the Database

Nebraska uses the PostgreSQL database, and expects the used database to be set to the UTC timezone.