Skip to content

Conversation

@mustela
Copy link
Collaborator

@mustela mustela commented Jun 2, 2025

This PR adds a step-by-step guide for running the network-services-operator locally, covering prerequisites, cluster setup, CRD installation, and local execution using make run. It’s aimed at improving the local development experience and onboarding for new contributors.

@mustela mustela requested a review from joshlreese June 2, 2025 09:56
@scotwells scotwells linked an issue Jun 2, 2025 that may be closed by this pull request
README.md Outdated
Comment on lines 74 to 78
1. Create a symbolic link to your kubeconfig:
```sh
ln -s ~/.kube/config ./infra.kubeconfig
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would not recommend making this symlink - the KUBECONFIG env var can be used, or option 2 as noted below.

README.md Outdated
2. Or modify the configuration in `config/dev/config.yaml` to point to your kubeconfig file:
```yaml
downstreamResourceManagement:
kubeconfigPath: /path/to/your/kubeconfig
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be the path to the .kind-nso-infra.yaml kubeconfig.

Maybe we can update the Makefile to have those exported somewhere automatically, or add sub commands for some of the actions below, to avoid manual steps and env var juggling?


# The topology of the location
topology:
topology.datum.net/city-code: "us-central1"
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should use a city code that'll work for IPAM today (Only DFW, DLS, and LHR will work at the moment):

Suggested change
topology.datum.net/city-code: "us-central1"
topology.datum.net/city-code: "DFW"

@mustela
Copy link
Collaborator Author

mustela commented Jun 20, 2025

@joshlreese updated!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add documentation for running the operator locally for development

3 participants