The standard configuration of Forklift package deployments for PlanktoScopes
pallet-standard is a Forklift pallet specifying the standard configuration of Forklift package deployments for the PlanktoScope software distribution.
This Github repository has three release channels, each corresponding to a Git branch: stable,
beta, and edge, as well as Git tags for each released version. You should probably use either
the stable branch (recommended so that you will automatically be notified for new stable versions)
or a specific Git tag.
You can clone and apply this Forklift pallet to your PlanktoScope using the
forklift tool. For example, you can run any
of the following forklift CLI commands, depending on which release of this pallet you want:
// to clone the latest development (unstable) version of the edge branch:
forklift plt switch github.com/PlanktoScope/pallet-standard@edge
// to clone the latest beta or stable (pre-)release of the edge branch:
forklift plt switch github.com/PlanktoScope/pallet-standard@beta
// to clone the latest stable release of the edge branch:
forklift plt switch github.com/PlanktoScope/pallet-standard@stable
// to clone the v2023.9.0 release:
forklift plt switch github.com/PlanktoScope/[email protected]
Warning: this will replace all Docker containers on your Docker host with the package deployments specified by this pallet and delete any Docker containers not specified by this pallet's package deployments.
TBD
You should clone this Github repository to your local file system. For example, you can clone the
latest unstable version (on the edge branch) of the
github.com/PlanktoScope/pallet-standard pallet
using the command:
git clone https://github.com/PlanktoScope/pallet-standard
Then you will need to download/install forklift in order to run its commands for development. For
more details and usage information, refer to the
readme for Forklift, especially the
"Work on a development pallet"
section.
The most common routine maintenance task will be to upgrade the version of the
github.com/PlanktoScope/device-pkgs repository used
by this pallet. You can do that using a command like the following:
forklift dev --cwd {path to your local copy of the pallet for development} plt add-repo github.com/PlanktoScope/device-pkgs@{version to upgrade to}
Forklift packages deployed by this pallet have their own software licenses, as specified in the Forklift repositories where those packages are published. Any source code provided with this Forklift pallet is covered by the following information, except where otherwise indicated:
Copyright Ethan Li and PlanktoScope project contributors
SPDX-License-Identifier: Apache-2.0 OR BlueOak-1.0.0
You can use the source code provided here either under the Apache 2.0 License or under the Blue Oak Model License 1.0.0; you get to decide. We are making the software available under the Apache license because it's OSI-approved, but we like the Blue Oak Model License more because it's easier to read and understand.