neosctl 0.0.3

Nortal Core CLI

Core CLI v0.0.3

Prerequisites

The following packages are used across python repositories. A global install of them all is highly recommended.

• Poetry
• Invoke
• Kubefwd

A running cluster from Local Helm with gateway service port forwarded. Details on port forwarding below.

WSL

If running on Windows, you may need to install distutils to install the service.

$ sudo apt-get install python3.10-distutils

Initial setup

$ invoke install-dev

Code Quality

Tests

invoke tests
invoke tests-coverage

Linting

invoke check-style
invoke isort

Running locally

Port forwarding

To access the gateway api locally, you will need to connect to the pod inside the cluster using kubefwd.

$ sudo kubefwd svc -n core -c ~/.kube/config

Neosctl

Prerequisite

$ poetry shell

Initialize profile

$ neosctl -p my-profile profile init
Initialising [default] profile.
Gateway API url [http://core-gateway.core-gateway:9000/api/gateway]: <http://gateway_api_url:port>
Registry API url [http://neos-registry.registry:80/api/registry]: <http://registry_api_url:port>
Username: <username>
Auth flow [keycloak]: <basic|keycloak>

$ cat ~/.neosctl

Login

$ neosctl -p=<my-profile> auth login

Commands to work with data products

$ neosctl product --help
$ neosctl metadata --help

Releases

Release management is handled using bump2version. The below commands will tag a new release. This will also update the helm chart version, this should not be manually changed.

$ invoke bump-patch
$ invoke bump-minor
$ invoke bump-major
> vX.Y.Z