feat(cli): make network commands idempotent with --force flags #6
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…agement
Implement declarative network specifications enabling version-controllable,
idempotent network definitions through YAML/JSON configuration files.
New commands:
- `lux network apply -f spec.yaml`: Create/update network from spec
- `lux network spec-export`: Export current state to specification file
Features:
- YAML/JSON schema for defining nodes, subnets, and blockchains
- Idempotent apply with diffing (only changes what's different)
- Dry-run mode to preview changes before applying
- Force mode to recreate existing resources
- Comprehensive validation with clear error messages
Example spec.yaml:
apiVersion: lux.network/v1
kind: Network
network:
name: mydevnet
nodes: 5
subnets:
- name: mychain
vm: subnet-evm
chainId: 12345
validators: 3
Make CLI commands safely repeatable without side effects: - network start: checks if running, reports status instead of error - Adds --force flag to restart even if already running - Adds --luxd-path to use local binary - Adds --no-snapshot for fresh start - network stop: handles gracefully if not running - Adds --force/--no-save to skip saving state - Returns success with message if already stopped - network deploy: prevents duplicate deployments with clear messages - Adds --force flag to clean and redeploy (local only) - Provides actionable options when blockchain exists All commands now follow idempotent design: running them multiple times produces the same result as running once, enabling safe automation.
zeekay
changed the title
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Make CLI commands safely repeatable without side effects:
lux network start- checks if running, reports status instead of error--forceflag to restart even if already running--luxd-pathto use local binary--no-snapshotfor fresh startlux network stop- handles gracefully if not running--force/--no-saveto skip saving statelux network deploy- prevents duplicate deployments with clear messages--forceflag to clean and redeploy (local only)All commands now follow idempotent design: running them multiple times
produces the same result as running once, enabling safe automation.
Test plan
lux network starttwice - second run should report statuslux network start --force- should restart networklux network stopwhen not running - should succeed with messagelux network deploy mychaintwice - should show optionslux network deploy mychain --force- should clean and redeploy