Router packages

The Stella Ops Router is a set of NuGet packages. A microservice author uses the client SDK and a client transport; a gateway operator runs the gateway tool or builds a gateway host from the gateway libraries and the server transports. This page lists which package serves which role and under which licence.

Install

Every package of a release is installed from the Stella Ops NuGet feed, https://nuget.stella-ops.org/v3/index.json. Versions have the form x.y.z-yyyyMMddTHHmmssZ: the UTC timestamp is the release’s first publication, and NuGet treats the form as a prerelease, so an install names the version or passes --prerelease:

dotnet add package StellaOps.Microservice --prerelease

Every Router package of one release shares one version, built from one commit; install the Router packages of one version together. The consumer rules (feed, version form, verifying a package) are in the NuGet library release guide.

Packages by role

Microservice author

Gateway operator or custom gateway host

StellaOps.Router.Gateway.Host is a .NET tool (command stellaops-router-gateway); the gateway host guide runs it.

Plugin author

Not packaged

StellaOps.Gateway.WebService (the Stella Ops gateway), StellaOps.Router.AspNet, StellaOps.Messaging.Plugins and StellaOps.Router.Plugins are used only inside Stella Ops hosts and are not published as packages.

Licences

Each package carries its licence file (LICENSE) and notice (NOTICE) and names its licence in its package metadata. A package under the Router licence carries the Stella Ops Router licence: the Business Source License 1.1 with the Router’s Additional Use Grant. An Apache-2.0 package carries the Apache License 2.0. The legal overview lists the licence texts and what each package carries, and the licensing guide describes the gateway’s licence monitor.

The Apache-2.0 packages carry this statement in their README:

The packages StellaOps.Canonical.Json, StellaOps.Components.Licensing, StellaOps.Cryptography.Abstractions, StellaOps.Cryptography.DefaultProvider, StellaOps.DependencyInjection, StellaOps.Messaging, StellaOps.Messaging.Transport.InMemory, StellaOps.Messaging.Transport.Postgres, StellaOps.Messaging.Transport.Valkey, StellaOps.Microservice, StellaOps.Microservice.AspNetCore, StellaOps.Microservice.SourceGen, StellaOps.Plugin, StellaOps.Router.Common, StellaOps.Router.Transport.InMemory, StellaOps.Router.Transport.Messaging, StellaOps.Router.Transport.RabbitMq, StellaOps.Router.Transport.Tcp, StellaOps.Router.Transport.Tls and StellaOps.Router.Transport.Udp are licensed under the Apache License, Version 2.0. They comprise the shared foundation packages, the general Messaging packages and the Router client packages (the client SDK, the client contracts and the client transports).

The Stella Ops Router gateway, the server transports and the rate-limiting packages, and the Stella Ops Workflow packages, are separate packages. They are licensed under the Business Source License 1.1 with the Additional Use Grant of the Router or Workflow licence. Those licences govern those separate packages only. They place no condition on the use of the Apache-licensed packages.

“Stella Ops” is a trading name of Е-САЛЮШЪНС ЕООД (e-Solutions EOOD). Use of the Licensor’s trade names and marks is governed by section 6 of the Apache License, Version 2.0. That section permits use as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.

Published versions

The table lists each Router and shared foundation package that has a published version, with its latest version. It is generated from the package catalogue and the publication register; no version is published yet.