Import Git Repositories
How to import a repo containing your service and manifests
To deploy your service with Plural, configure your repository with a folder containing your Kubernetes manifests that indicates how your service should be deployed. As an example, you can check out the charts folder of the Plural Deployment Operator.
We currently support helm, kustomize and raw kubernetes manifests to define your application. Service configuration can be templated in, either at the
values.yaml file level for helm, or directly in kubernetes manifests for raw folders. You can see an example of a templated yaml file in
charts/deployment-operator/values.yaml.liquid at the link above, and for slightly simpler templating an example can be found in our guestbook test app here.
We are going to be adding support for CDK8s, CUE and some other formats imminently, send us a github issue if you want to add support and contributions are always welcome!
To deploy a service, Plural needs to pull the Git repository containing your Kubernetes manifests. Navigate to the "Git repositories" subtab and click the "Import Git" button in the top right corner.
Connect your repo by adding the URL. Plural supports both SSH and basic auth. If your manifests are located in a private repo, add your credentials via upload or manual entry.
Plural will then attempt to connect to the repository. If successful, the status will update to
Pullable, and you can then deploy your service from the "Services" subtab.
To update the repository URL, use the
Update button inline with the repository row.
To import a repo via the CLI, use the
plural cd repositories create command. Provide the URL and any authentication required. As an example:
plural cd repositories create --url https://github.com/helm/examples.git
You should then see your repository show up when calling
plural cd repositories list.