Contributing

Thank you for your interest in contributing to the 1Password Kubernetes Operator project 👋! Before you start, please take a moment to read through this guide to understand our contribution process.

Testing

To run e2e tests:

Install kind to spin up local Kubernetes cluster.
export OP_CONNECT_TOKEN=<token>
export OP_SERVICE_ACCOUNT_TOKEN=<token>
make test-e2e

In case tests are failed, before running them again, reset kind using make cleanup-test-e2e

For functional testing, run the local version of the operator. From the project root:

# Go to the K8s environment (e.g. minikube)
eval $(minikube docker-env)

# Build the local Docker image for the operator
make docker-build

# Deploy the operator
make deploy

# Remove the operator from K8s
make undeploy

After making changes to the code:

Rebuild the Docker image by running make docker-build
Restart deployment make restart

For testing the changes made to the OnePasswordItem Custom Resource Definition (CRD), you need to re-generate the object:
```
make manifests
```
Run tests for the operator:
```
make test
```

You can check other available commands that may come in handy by running make help.

Debugging

Running kubectl describe pod will fetch details about pods. This includes configuration information about the container(s) and Pod (labels, resource requirements, etc) and status information about the container(s) and Pod (state, readiness, restart count, events, etc.).
Running kubectl logs ${POD_NAME} ${CONTAINER_NAME} will print the logs from the container(s) in a pod. This can help with debugging issues by inspection.
Running kubectl exec ${POD_NAME} -c ${CONTAINER_NAME} -- ${CMD} allows executing a command inside a specific container.

For more debugging documentation, see: https://kubernetes.io/docs/tasks/debug/debug-application/debug-pods/

Documentation Updates

If applicable, update the USAGEGUIDE.md and README.md to reflect any changes introduced by the new code.

Sign your commits

To get your PR merged, we require you to sign your commits. There are three options you can choose from.

Sign commits with 1Password

You can sign commits using 1Password, which lets you sign commits with biometrics without the signing key leaving the local 1Password process.

Learn how to use 1Password to sign your commits.

Sign commits with ssh-agent

Follow the steps below to set up commit signing with ssh-agent:

Sign commits with gpg

Follow the steps below to set up commit signing with gpg:

3.8 KiB Raw Blame History