Thank you for taking the time out to contribute to project Nephe!.
Nephe project scaffold is created via Kubebuilder.
To install kubebuilder version 3
, please refer to
kubebuilder quick start guide.
The following tools are required to build, test and run Nephe Controller
.
NOTE: Only the above versions are validated by Nephe.
To build the antrea/nephe
image, you can simply do:
- Checkout your branch and
cd
into it. - Run
make
.
The nephe-controller
binary is located in ./bin
directory and the docker
image antrea/nephe:latest
is created or updated in the local docker repository.
Nephe manifest deploys one Nephe controller
Deployment. All the
Nephe Controller
related resources are namespaced under nephe-system
.
kubectl apply -f config/nephe.yml
kubectl get deployment -A
# Output
NAMESPACE NAME READY UP-TO-DATE AVAILABLE AGE
cert-manager cert-manager 1/1 1 1 41m
cert-manager cert-manager-cainjector 1/1 1 1 41m
cert-manager cert-manager-webhook 1/1 1 1 41m
kube-system antrea-controller 1/1 1 1 41m
nephe-system nephe-controller 1/1 1 1 40m
kube-system coredns 2/2 2 2 43m
local-path-storage local-path-provisioner 1/1 1 1 43m
Project Nephe follows the Antrea Developer Guide. Also check out Nephe documents for more information about nephe. The following sections have different content from Antrea Developer Guide. Please read them carefully when referring to Antrea Developer Guide.
When following GitHub Workflow in Antrea, please make sure to change the name of repository from antrea to nephe.
In Nephe, we have trigger phrases to run AWS and Azure tests on AKS, EKS and Kind cluster. Only Nephe maintainers will be able to add the trigger phrases in the PR. Please run the required tests locally for your PR, and then reach out to maintainers.
Here are the trigger phrases for individual checks:
/nephe-test-e2e-aws
: Run end-to-end AWS tests on a Kind cluster with AWS VMs/nephe-test-e2e-azure
: Run end-to-end Azure tests on a Kind cluster with Azure VMs/nephe-test-e2e-eks
: Run end-to-end AWS tests on EKS cluster with AWS VMs/nephe-test-e2e-aks
: Run end-to-end Azure tests on AKS cluster with Azure VMs
Here are the trigger phrases for groups of checks:
/nephe-test-e2e-kind
: Run end-to-end tests on a Kind cluster./nephe-test-e2e-all
: Runs all the end-to-end tests.
For more information about the tests we run as part of CI, please refer to ci/jenkins/README.md.