init: hello world fluence v2!

I have the traditional compute scheduling working with PodGroup
(kubernetes 1.36.1) and am thinking about how to model the quantum
resource request next. Stay tuned!

Signed-off-by: vsoch <vsoch@users.noreply.github.com>

Author: vsoch

.devcontainer/Dockerfile

@@ -0,0 +1,89 @@
+FROM fluxrm/flux-core:noble
+
+LABEL maintainer="Vanessasaurus <@vsoch>"
+
+# Match the default user id for a single system so we aren't root
+ARG USERNAME=vscode
+ARG USER_UID=1000
+ARG USER_GID=1000
+ENV USERNAME=${USERNAME}
+ENV USER_UID=${USER_UID}
+ENV USER_GID=${USER_GID}
+USER root
+
+# Install extra buildrequires for flux-sched:
+RUN sudo apt-get update && \
+    sudo apt-get -qq install -y --no-install-recommends \
+        libboost-graph-dev \
+        libboost-system-dev \
+        libboost-filesystem-dev \
+        libboost-regex-dev \
+        python3-yaml \
+        libyaml-cpp-dev \
+        libedit-dev \
+        ninja-build \
+        cmake \
+        curl
+
+# Assuming installing to /usr/local
+ENV LD_LIBRARY_PATH=/usr/lib:/usr/local/lib
+
+# Install Go 19 for TBA bindings (if Go bindings desired)
+RUN wget https://go.dev/dl/go1.26.0.linux-amd64.tar.gz  && tar -xvf go1.26.0.linux-amd64.tar.gz && \
+         mv go /usr/local && rm go1.26.0.linux-amd64.tar.gz
+ENV PATH=$PATH:/usr/local/go/bin:/home/vscode/go/bin
+
+# extra interactive utilities
+RUN sudo apt-get update \
+ && sudo apt-get -qq install -y --no-install-recommends \
+    fd-find \
+    less \
+    bats \
+    ripgrep \
+    libczmq-dev
+
+
+# --- Rust (for building QRMI) --------------------------------------------
+# Installed system-wide so it is available regardless of the active user.
+# QRMI pins its toolchain via rust-toolchain.toml (currently 1.91); rustup will
+# fetch that automatically during the build below.
+ENV RUSTUP_HOME=/usr/local/rustup \
+    CARGO_HOME=/usr/local/cargo \
+    PATH=/usr/local/cargo/bin:$PATH
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs \
+      | sh -s -- -y --no-modify-path --profile minimal --default-toolchain 1.91 \
+ && chmod -R a+rwX /usr/local/rustup /usr/local/cargo
+
+ # --- QRMI native library (the bindings' cgo dependency) ------------------
+# Pin QRMI_REF to a tag/commit for reproducibility if you like; defaults to main.
+ARG QRMI_REPO=https://github.com/qiskit-community/qrmi
+ARG QRMI_REF=main
+RUN git clone ${QRMI_REPO} /opt/qrmi \
+ && cd /opt/qrmi \
+ && git checkout ${QRMI_REF} \
+ && cargo build --locked --release \
+ && install -d /usr/local/include /usr/local/lib \
+ && install -m 0644 qrmi.h /usr/local/include/qrmi.h \
+ && install -m 0644 target/release/libqrmi.a /usr/local/lib/libqrmi.a \
+ && install -m 0755 target/release/libqrmi.so /usr/local/lib/libqrmi.so \
+ && ldconfig
+
+# Add the group and user that match our ids
+RUN groupadd -g ${USER_GID} ${USERNAME} && \
+    adduser --disabled-password --uid ${USER_UID} --gid ${USER_GID} --gecos "" ${USERNAME} && \
+    echo "${USERNAME} ALL=(ALL) NOPASSWD: ALL" > /etc/sudoers
+
+# This branch of flux-sched has the bindings we need!
+RUN ln -s /usr/local/go/bin/go /usr/bin/go && \
+    git clone https://github.com/flux-framework/flux-sched /opt/flux-sched && \
+    cd /opt/flux-sched && \
+    export WITH_GO=yes && \
+    ./configure --prefix=/usr && \
+    mkdir build && \
+    cd build && \
+    cmake ../ && \ 
+    cd ../ && \
+    make && make install
+
+ENV LD_LIBRARY_PATH=/usr/lib:/opt/flux-sched/resource:/opt/flux-sched/resource/reapi/bindings:/opt/flux-sched/resource/libjobspec
+USER $USERNAME

.devcontainer/Dockerfile.old

@@ -0,0 +1,63 @@
+FROM fluxrm/flux-core:bookworm
+
+LABEL maintainer="Vanessasaurus <@vsoch>"
+
+# Match the default user id for a single system so we aren't root
+ARG USERNAME=vscode
+ARG USER_UID=1000
+ARG USER_GID=1000
+ENV USERNAME=${USERNAME}
+ENV USER_UID=${USER_UID}
+ENV USER_GID=${USER_GID}
+USER root
+
+# Install extra buildrequires for flux-sched:
+RUN sudo apt-get update
+RUN sudo apt-get -qq install -y --no-install-recommends \
+        libboost-graph-dev \
+        libboost-system-dev \
+        libboost-filesystem-dev \
+        libboost-regex-dev \
+        python3-yaml \
+        libyaml-cpp-dev \
+        libedit-dev \
+        ninja-build \
+        curl
+
+# Assuming installing to /usr/local
+ENV LD_LIBRARY_PATH=/usr/lib:/usr/local/lib
+
+RUN curl -s -L https://github.com/Kitware/CMake/releases/download/v3.26.4/cmake-3.26.4-linux-$(uname -m).sh > cmake.sh ;\
+    sudo bash cmake.sh --prefix=/usr/local --skip-license ;\
+    rm cmake.sh
+
+# Install Go 19 for TBA bindings (if Go bindings desired)
+RUN wget https://go.dev/dl/go1.19.10.linux-amd64.tar.gz  && tar -xvf go1.19.10.linux-amd64.tar.gz && \
+         mv go /usr/local && rm go1.19.10.linux-amd64.tar.gz
+ENV PATH=$PATH:/usr/local/go/bin:/home/vscode/go/bin
+
+# extra interactive utilities
+RUN apt-get update \
+ && apt-get -qq install -y --no-install-recommends \
+    fd-find \
+    less \
+    bats \
+    ripgrep
+
+# Add the group and user that match our ids
+RUN groupadd -g ${USER_GID} ${USERNAME} && \
+    adduser --disabled-password --uid ${USER_UID} --gid ${USER_GID} --gecos "" ${USERNAME} && \
+    echo "${USERNAME} ALL=(ALL) NOPASSWD: ALL" > /etc/sudoers
+
+# This branch of flux-sched has the bindings we need!
+RUN git clone -b lib-updates https://github.com/milroy/flux-sched /opt/flux-sched && \
+    cd /opt/flux-sched && \
+    export WITH_GO=yes && \
+    ./configure --prefix=/usr && \
+    mkdir build && \
+    cd build && \
+    cmake ../ && \ 
+    cd ../ && \
+    make && make install
+
+USER $USERNAME

.devcontainer/devcontainer.json

@@ -0,0 +1,18 @@
+{
+  "name": "Fluxion (Fluence) with Quantum",
+  "dockerFile": "Dockerfile",
+  "context": "../",
+
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "terminal.integrated.defaultProfile.linux": "bash"
+  },
+      "extensions": [
+        "ms-vscode.cmake-tools",
+        "golang.go"
+      ]
+    }
+  },
+  "postStartCommand": "git config --global --add safe.directory /workspaces/fluence"
+}

.dockerignore

@@ -0,0 +1,3 @@
+bin/
+.git/
+*.tar.gz

.gitignore

@@ -0,0 +1,2 @@
+vendor
+bin

COPYRIGHT

@@ -0,0 +1,15 @@
+Intellectual Property Notice
+----------------------------
+
+HPCIC DevTools is licensed under the MIT license (LICENSE).
+
+Copyrights and patents in this project are retained by
+contributors. No copyright assignment is required to contribute to
+HPCIC DevTools.
+
+SPDX usage
+------------
+
+Individual files contain SPDX tags instead of the full license text.
+This enables machine processing of license information based on the SPDX
+License Identifiers that are available here: https://spdx.org/licenses/

Dockerfile

@@ -0,0 +1,58 @@
+# Multi-stage build for the fluence scheduler.
+#
+# The scheduler binary cgo-links flux-sched (Fluxion) for resource matching.
+# It does NOT depend on QRMI — quantum job submission is a separate workload
+# (github.com/converged-computing/qrmi-sampler). So this image needs only
+# flux-sched, no Rust/QRMI. Mirrors the .devcontainer build.
+
+# ---------- builder ----------
+FROM fluxrm/flux-core:noble AS builder
+
+USER root
+ENV LD_LIBRARY_PATH=/usr/lib:/usr/local/lib
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        libboost-graph-dev libboost-system-dev libboost-filesystem-dev \
+        libboost-regex-dev libyaml-cpp-dev libedit-dev libczmq-dev \
+        python3-yaml ninja-build cmake curl git wget ca-certificates \
+ && rm -rf /var/lib/apt/lists/*
+
+# Go toolchain
+RUN wget -q https://go.dev/dl/go1.26.0.linux-amd64.tar.gz \
+ && tar -C /usr/local -xzf go1.26.0.linux-amd64.tar.gz && rm go1.26.0.linux-amd64.tar.gz
+ENV PATH=$PATH:/usr/local/go/bin
+
+# flux-sched (Fluxion) with the Go reapi bindings -> /usr; build tree at /opt/flux-sched
+RUN git clone https://github.com/flux-framework/flux-sched /opt/flux-sched \
+ && cd /opt/flux-sched && export WITH_GO=yes && ./configure --prefix=/usr \
+ && mkdir build && cd build && cmake ../ && cd ../ && make -j"$(nproc)" && make install
+ENV FLUX_SCHED_ROOT=/opt/flux-sched
+
+# Build the scheduler
+WORKDIR /src
+COPY go.mod go.sum* ./
+RUN go mod download || true
+COPY . .
+RUN CGO_ENABLED=1 \
+    CGO_CFLAGS="-I/opt/flux-sched" \
+    CGO_LDFLAGS="-L/opt/flux-sched/resource -L/opt/flux-sched/resource/libjobspec -L/opt/flux-sched/resource/reapi/bindings -lresource -ljobspec_conv -lreapi_cli -lflux-idset -lstdc++ -lczmq -ljansson -lhwloc -lboost_system -lflux-hostlist -lboost_graph -lyaml-cpp" \
+    go build -ldflags '-w' -o /bin/fluence ./cmd/fluence
+
+FROM fluxrm/flux-core:noble AS runtime
+
+USER root
+ENV LD_LIBRARY_PATH=/usr/lib:/opt/flux-sched/resource:/opt/flux-sched/resource/reapi/bindings:/opt/flux-sched/resource/libjobspec
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        libboost-graph1.83.0 libboost-system1.83.0 libyaml-cpp0.8 libczmq4 libjansson4 libhwloc15 \
+ && rm -rf /var/lib/apt/lists/*
+
+COPY --from=builder /opt/flux-sched/resource /opt/flux-sched/resource
+COPY --from=builder /usr/lib/libresource.so* /usr/lib/
+COPY --from=builder /usr/lib/libreapi_cli.so* /usr/lib/
+COPY --from=builder /usr/lib/libjobspec_conv.so* /usr/lib/
+RUN ldconfig
+
+COPY --from=builder /bin/fluence /bin/fluence
+ENTRYPOINT ["/bin/fluence"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022-2023 LLNS, LLC and other HPCIC DevTools Developers.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Makefile

@@ -0,0 +1,45 @@
+# fluence — Kubernetes scheduler plugin backed by Fluxion (flux-sched), with
+# optional quantum resources modeled in the resource graph.
+#
+# The scheduler only schedules. It links flux-sched (the matcher) and does NOT
+# depend on QRMI — quantum job submission lives in a separate workload container
+# (github.com/converged-computing/qrmi-sampler), not here.
+
+FLUX_SCHED_ROOT ?= /opt/flux-sched
+IMG             ?= ghcr.io/converged-computing/fluence:latest
+
+# cgo flags for the scheduler binary: flux-sched only.
+CGO_CFLAGS  = -I$(FLUX_SCHED_ROOT)
+CGO_LDFLAGS = -L$(FLUX_SCHED_ROOT)/resource \
+              -L$(FLUX_SCHED_ROOT)/resource/libjobspec \
+              -L$(FLUX_SCHED_ROOT)/resource/reapi/bindings \
+              -lresource -ljobspec_conv -lreapi_cli -lflux-idset \
+              -lstdc++ -lczmq -ljansson -lhwloc -lboost_system \
+              -lflux-hostlist -lboost_graph -lyaml-cpp
+
+.PHONY: build
+build: ## Build the fluence scheduler binary (needs flux-sched)
+	CGO_ENABLED=1 CGO_CFLAGS="$(CGO_CFLAGS)" CGO_LDFLAGS="$(CGO_LDFLAGS)" \
+	  go build -o bin/fluence ./cmd/fluence
+
+.PHONY: test
+test: ## Pure-Go unit tests (no flux, no k8s scheduler libs, no cluster)
+	go test ./pkg/jgf/... ./pkg/cluster/... ./pkg/jobspec/... ./pkg/placement/... ./pkg/quantum/...
+
+.PHONY: test-graph
+test-graph: ## Matcher tests (needs flux-sched)
+	CGO_ENABLED=1 CGO_CFLAGS="$(CGO_CFLAGS)" CGO_LDFLAGS="$(CGO_LDFLAGS)" \
+	  go test ./pkg/graph/...
+
+.PHONY: image
+image: ## Build the scheduler container image
+	docker build -t $(IMG) .
+
+.PHONY: deploy
+deploy: ## Install RBAC + scheduler into kube-system
+	kubectl apply -f deploy/fluence.yaml
+
+.PHONY: help
+help:
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
+	  awk 'BEGIN{FS=":.*?## "}{printf "  %-14s %s\n", $$1, $$2}'

NOTICE

@@ -0,0 +1,21 @@
+This work was produced under the auspices of the U.S. Department of
+Energy by Lawrence Livermore National Laboratory under Contract
+DE-AC52-07NA27344.
+
+This work was prepared as an account of work sponsored by an agency of
+the United States Government. Neither the United States Government nor
+Lawrence Livermore National Security, LLC, nor any of their employees
+makes any warranty, expressed or implied, or assumes any legal liability
+or responsibility for the accuracy, completeness, or usefulness of any
+information, apparatus, product, or process disclosed, or represents that
+its use would not infringe privately owned rights.
+
+Reference herein to any specific commercial product, process, or service
+by trade name, trademark, manufacturer, or otherwise does not necessarily
+constitute or imply its endorsement, recommendation, or favoring by the
+United States Government or Lawrence Livermore National Security, LLC.
+
+The views and opinions of authors expressed herein do not necessarily
+state or reflect those of the United States Government or Lawrence
+Livermore National Security, LLC, and shall not be used for advertising
+or product endorsement purposes.