CI/CD: Publish Operator image (#180)

- Publish Operator container image to GHCR
    - Modern Debian (bookworm)
    - Correct Rust version (1.85.0)
    - No error masking
    - Ulimits set at runtime, not build time
- Create Makefile to run the command for NCN keeper and operator
- Update README.md

#### NOTE

Build
```bash
 docker build -f tip-router-operator-cli/Dockerfile .
```

Build with log

```bash
docker build --progress=plain --no-cache -f tip-router-operator-cli/Dockerfile .
```

Author: aoikurokawa

.github/workflows/build-container-images.yaml

@@ -10,6 +10,7 @@ on:
         type: choice
         options:
           - ncn-keeper
+          - operator
 
 env:
   REGISTRY: ghcr.io
@@ -32,31 +33,38 @@ jobs:
         username: ${{ github.actor }}
         password: ${{ secrets.GITHUB_TOKEN }}
 
-    - name: Determine Docker target and image name
+    - name: Set image configuration
       id: config
       run: |
         case "${{ github.event.inputs.service_config }}" in
           "ncn-keeper")
             echo "target=jito-tip-router-ncn-keeper" >> $GITHUB_OUTPUT
-            echo "service=jito-tip-router-ncn-keeper" >> $GITHUB_OUTPUT
-            echo "image_name=${{ github.repository }}/jito-tip-router-ncn-keeper" >> $GITHUB_OUTPUT
+            echo "image_name=jito-tip-router-ncn-keeper" >> $GITHUB_OUTPUT
+            echo "dockerfile_path=./cli/Dockerfile" >> $GITHUB_OUTPUT
+            echo "context_path=./cli" >> $GITHUB_OUTPUT
+            ;;
+          "operator")
+            echo "target=tip-router-operator-cli" >> $GITHUB_OUTPUT
+            echo "image_name=tip-router-operator-cli" >> $GITHUB_OUTPUT
+            echo "dockerfile_path=./tip-router-operator-cli/Dockerfile" >> $GITHUB_OUTPUT
+            echo "context_path=./tip-router-operator-cli" >> $GITHUB_OUTPUT
             ;;
         esac
 
     - name: Extract metadata
       id: meta
       uses: docker/metadata-action@v5
       with:
-        images: ${{ env.REGISTRY }}/${{ steps.config.outputs.image_name }}
+        images: ${{ env.REGISTRY }}/${{ github.repository }}/${{ steps.config.outputs.image_name }}
         tags: |
-          type=raw,value={{sha}}
-          type=raw,value=latest
+          type=raw,value=${{ github.ref_name }}-${{ github.event.inputs.service_config }}-{{sha}}
+          type=raw,value=${{ github.ref_name }}-${{ github.event.inputs.service_config }}-latest
 
     - name: Build and push container
       uses: docker/build-push-action@v5
       with:
-        context: .
-        file: ./cli/Dockerfile
+        context: ${{ steps.config.outputs.context_path }}
+        file: ${{ steps.config.outputs.dockerfile_path }}
         target: ${{ steps.config.outputs.target }}
         platforms: linux/amd64
         push: true

Makefile

@@ -0,0 +1,80 @@
+# Docker management Makefile for Jito Tip Router
+
+# Default target
+.PHONY: help
+help:
+	@echo "Available targets:"
+	@echo "NCN Keeper commands:"
+	@echo "  ncn-keeper-start         - Start the main keeper service"
+	@echo "  ncn-keeper-start-metrics - Start the metrics-only keeper service" 
+	@echo "  ncn-keeper-start-migrate - Start the migrate-only keeper service"
+	@echo "  ncn-keeper-stop          - Stop and remove the main keeper service"
+	@echo "  ncn-keeper-stop-metrics  - Stop and remove the metrics-only keeper service"
+	@echo "  ncn-keeper-logs          - Follow logs for the main keeper service"
+	@echo "  ncn-keeper-logs-metrics  - Follow logs for the metrics-only keeper service"
+	@echo "  ncn-keeper-logs-migrate  - Follow logs for the migrate-only keeper service"
+	@echo "  ncn-keeper-start-all     - Start all NCN keeper services"
+	@echo "  operator-start           - Start the tip router operator service"
+	@echo "  operator-stop            - Stop and remove the tip router operator service"
+	@echo "  operator-logs            - Follow logs for the tip router operator service"
+	@echo ""
+	@echo "Utility commands:"
+	@echo "  start-all                - Start all services (NCN keeper + operator)"
+	@echo "  clean                    - Stop and remove all services"
+
+# NCN Keeper services
+.PHONY: ncn-keeper-start
+ncn-keeper-start:
+	docker compose --env-file cli/.env up -d --build jito-tip-router-ncn-keeper --remove-orphans
+
+.PHONY: ncn-keeper-start-metrics
+ncn-keeper-start-metrics:
+	docker compose --env-file cli/.env up -d --build jito-tip-router-ncn-keeper-metrics-only --remove-orphans
+
+.PHONY: ncn-keeper-start-migrate
+ncn-keeper-start-migrate:
+	docker compose --env-file cli/.env up -d --build jito-tip-router-ncn-keeper-migrate-only --remove-orphans
+
+.PHONY: ncn-keeper-start-all
+ncn-keeper-start-all: ncn-keeper-start ncn-keeper-start-metrics ncn-keeper-start-migrate
+	@echo "All NCN keeper services started"
+
+# Operator services
+.PHONY: operator-start
+operator-start:
+	docker compose --env-file tip-router-operator-cli/.env up -d --build tip-router-operator-cli --remove-orphans
+
+# NCN Keeper stop commands
+.PHONY: ncn-keeper-stop
+ncn-keeper-stop:
+	docker stop jito-tip-router-ncn-keeper || true
+	docker rm jito-tip-router-ncn-keeper || true
+
+.PHONY: ncn-keeper-stop-metrics
+ncn-keeper-stop-metrics:
+	docker stop jito-tip-router-ncn-keeper-metrics-only || true
+	docker rm jito-tip-router-ncn-keeper-metrics-only || true
+
+# Operator stop commands
+.PHONY: operator-stop
+operator-stop:
+	docker stop tip-router-operator-cli || true
+	docker rm tip-router-operator-cli || true
+
+# NCN Keeper logs
+.PHONY: ncn-keeper-logs
+ncn-keeper-logs:
+	docker logs jito-tip-router-ncn-keeper -f
+
+.PHONY: ncn-keeper-logs-metrics
+ncn-keeper-logs-metrics:
+	docker logs jito-tip-router-ncn-keeper-metrics-only -f
+
+.PHONY: ncn-keeper-logs-migrate
+ncn-keeper-logs-migrate:
+	docker logs jito-tip-router-ncn-keeper-migrate-only -f
+
+# Operator logs
+.PHONY: operator-logs
+operator-logs:
+	docker logs tip-router-operator-cli -f

README.md

@@ -1,5 +1,56 @@
 # Jito Tip Router
 
+## Overview
+
+Jito Tip Router NCN will assume programmatic operations related to the distribution of MEV tips generated from the Jito Tip Distribution protocol every epoch, and, as part of these programmatic operations, will route some portion of all MEV tips collected to the DAO treasury and the NCN network participants.
+
+## Development Setup
+
+### Docker Services Management
+
+This project includes a Makefile for easy management of Docker services. Use `make help` to see all available commands.
+
+#### NCN Keeper Services
+
+```bash
+# Start services
+make ncn-keeper-start          # Main keeper service
+make ncn-keeper-start-metrics  # Metrics-only service  
+make ncn-keeper-start-migrate  # Migration-only service
+make ncn-keeper-start-all      # Start all NCN keeper services
+
+# View logs
+make ncn-keeper-logs           # Main keeper logs
+make ncn-keeper-logs-metrics   # Metrics service logs
+make ncn-keeper-logs-migrate   # Migration service logs
+
+# Stop services
+make ncn-keeper-stop           # Stop main keeper
+make ncn-keeper-stop-metrics   # Stop metrics service
+```
+
+#### Operator Services
+
+```bash
+# Operator management
+make start-operator # Start tip router operator
+make logs-operator  # View operator logs
+make stop-operator  # Stop operator service
+```
+
+#### Utility Commands
+
+```bash
+make help           # Show all available commands
+```
+
+### Container Images
+
+The project uses GitHub Actions to build container images for two main services:
+
+- **NCN Keeper**: `jito-tip-router-ncn-keeper` (built from `./cli/`)
+- **Operator**: `tip-router-operator-cli` (built from `./tip-router-operator-cli/`)
+
 ## Testing Setup
 
 ### Prerequisites

docker-compose.yaml

@@ -82,3 +82,40 @@ services:
     volumes:
       - ./credentials:/credentials
     restart: on-failure:5
+
+  tip-router-operator-cli:
+    build:
+      context: ./tip-router-operator-cli
+      dockerfile: Dockerfile
+    container_name: tip-router-operator-cli
+    environment:
+      - RUST_LOG=${RUST_LOG:-info}
+      - KEYPAIR_PATH=${KEYPAIR_PATH}
+      - LEDGER_PATH=${LEDGER_PATH}
+      - ACCOUNT_PATHS=${ACCOUNT_PATHS}
+      - FULL_SNAPSHOTS_PATH=${FULL_SNAPSHOTS_PATH}
+      - SNAPSHOT_OUTPUT_DIR=${SNAPSHOT_OUTPUT_DIR}
+      - OPERATOR_ADDRESS=${OPERATOR_ADDRESS}
+      - RPC_URL=${RPC_URL}
+      - NCN_ADDRESS=${NCN_ADDRESS}
+      - TIP_DISTRIBUTION_PROGRAM_ID=${TIP_DISTRIBUTION_PROGRAM_ID}
+      - TIP_PAYMENT_PROGRAM_ID=${TIP_PAYMENT_PROGRAM_ID}
+      - ENABLE_SNAPSHOTS=${ENABLE_SNAPSHOTS:-false}
+      - TIP_ROUTER_PROGRAM_ID=${TIP_ROUTER_PROGRAM_ID}
+      - NUM_MONITORED_EPOCHS=${NUM_MONITORED_EPOCHS:-3}
+      - START_NEXT_EPOCH=${START_NEXT_EPOCH:-false}
+      - SAVE_PATH=${SAVE_PATH}
+      - BACKUP_SNAPSHOTS_DIR=${BACKUP_SNAPSHOTS_DIR}
+      - SOLANA_METRICS_CONFIG=${SOLANA_METRICS_CONFIG}
+      - SET_MERKLE_ROOTS=${SET_MERKLE_ROOTS:-false}
+      - CLAIM_TIPS=${CLAIM_TIPS:-false}
+      - STARTING_STAGE=${STARTING_STAGE:-wait-for-next-epoch}
+    volumes:
+      - ./credentials:/credentials
+      - ${LEDGER_PATH}:${LEDGER_PATH}
+      - ${ACCOUNT_PATHS}:${ACCOUNT_PATHS}
+      - ${FULL_SNAPSHOTS_PATH}:${FULL_SNAPSHOTS_PATH}
+      - ${SNAPSHOT_OUTPUT_DIR}:${SNAPSHOT_OUTPUT_DIR}
+      - ${SAVE_PATH}:${SAVE_PATH}
+      - ${BACKUP_SNAPSHOTS_DIR}:${BACKUP_SNAPSHOTS_DIR}
+    restart: on-failure:5