pulumi-argocd 1.0.0

A Pulumi package for creating and managing Argo CD resources.

Argo CD Resource Provider

The Argo CD Resource Provider lets you manage Argo CD resources.

Installing

This package is available for several languages/platforms:

Node.js (JavaScript/TypeScript)

To use from JavaScript or TypeScript in Node.js, install using either npm:

npm install @three14/pulumi-argocd

or yarn:

yarn add @three14/pulumi-argocd

Python

To use from Python, install using pip:

pip install pulumi-argocd

Go

To use from Go, use go get to grab the latest version of the library:

go get github.com/pulumi/pulumi-argocd/sdk/go/...

.NET

To use from .NET, install using dotnet add package:

dotnet add package Three14.Argocd

Configuration

The following configuration points are available for the argocd provider:

• argocd:auth_token (String, Sensitive) ArgoCD authentication token, takes precedence over username/password. Can be set through the ARGOCD_AUTH_TOKEN environment variable.

• argocd:cert_file (String) Additional root CA certificates file to add to the client TLS connection pool.

• argocd:client_cert_file (String) Client certificate.

• argocd:client_cert_key (String) Client certificate key.

• argocd:config_path (String) Override the default config path of $HOME/.config/argocd/config. Only relevant when argocd:use_local_config. Can be set through the ARGOCD_CONFIG_PATH environment variable.

• argocd:context (String) Context to choose when using a local ArgoCD config file. Only relevant when use_local_config. Can be set through ARGOCD_CONTEXT environment variable.

• argocd:core (Boolean) Configure direct access using Kubernetes API server.

  Warning: this feature works by starting a local ArgoCD API server that talks directly to the Kubernetes API using the current context in the default kubeconfig (~/.kube/config). This behavior cannot be overridden using either environment variables or the kubernetes block in the provider configuration at present).

  If the server fails to start (e.g. your kubeconfig is misconfigured) then the provider will fail as a result of the argocd module forcing it to exit and no logs will be available to help you debug this. The error message will be similar to

  The plugin encountered an error, and failed to respond to the plugin.(*GRPCProvider).ReadResource call. The plugin logs may contain more details.

  To debug this, you will need to login via the ArgoCD CLI using argocd login --core and then running an operation. E.g. argocd app list.

• argocd:grpc_web (Boolean) Whether to use gRPC web proxy client. Useful if Argo CD server is behind proxy which does not support HTTP2.

• argocd:grpc_web_root_path (String) Use the gRPC web proxy client and set the web root, e.g. argo-cd. Useful if the Argo CD server is behind a proxy at a non-root path.

• argocd:headers (Set of String) Additional headers to add to each request to the ArgoCD server.

• argocd:insecure (Boolean) Whether to skip TLS server certificate. Can be set through the ARGOCD_INSECURE environment variable.

• argocd:password (String, Sensitive) Authentication password. Can be set through the ARGOCD_AUTH_PASSWORD environment variable.

• argocd:plain_text (Boolean) Whether to initiate an unencrypted connection to ArgoCD server.

• argocd:port_forward (Boolean) Connect to a random argocd-server port using port forwarding.

• argocd:port_forward_with_namespace (String) Namespace name which should be used for port forwarding.

• argocd:server_addr (String) ArgoCD server address with port. Can be set through the ARGOCD_SERVER environment variable.

• argocd:use_local_config (Boolean) Use the authentication settings found in the local config file. Useful when you have previously logged in using SSO. Conflicts with auth_token, username and password.

• argocd:user_agent (String) User-Agent request header override.

• argocd:username (String) Authentication username. Can be set through the ARGOCD_AUTH_USERNAME environment variable.

Reference

For detailed reference documentation, please visit the Pulumi registry.