Import Git Repositories

Structure

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!

Import from the Browser

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.

Import from the CLI

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.