Get Started ¶
This documentation provides a method to quickly deploy containerized images of Ping Identity products via this documentation. Ping Identity images should be compatible across a variety of container platforms including Docker and Kubernetes (Including via Helm Charts). Our getting started configurations are designed to provide working instances of our products either as standalone containers or in orchestrated sets.
To quickly try Ping products, you will need an environment to deploy to. Rancher Desktop provides a great platform to get started with local Kubernetes development is compatible with Linux, MacOS, and Windows (using WSL). Rancher Desktop also supports the docker container runtime, which provides support for running docker commands without installing individual docker components or Docker Desktop.
Required Utilities ¶
-
You have access to a Kubernetes cluster. For local Kubernetes work, Rancher Desktop can provide a local Kubernetes cluster.
Kubernetes alternative
Alternatively, you may install
kubectl
andhelm
using brew or your preferred package manager:Installing helm and kubectl individually assumes you have a Kubernetes cluster available, either on a cloud platform such as AWS, Azure, GCP, or other or locally via Minikube, Kind, CodeReady Containers, etc.brew install helm brew install kubectl
-
Homebrew for package installation and management.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-
brew install pingidentity/tap/pingctl
Recommended Additional Utilities ¶
- k9s
brew install derailed/k9s/k9s
- kubectx
brew install kubectx
-
brew install docker-compose
docker-compose installation note
Installing docker-compose is only necessary to deploy Docker containers when using docker with Rancher Desktop. See Rancher preferences to switch from containerd to dockerd (moby).
Product license ¶
You must have a product license to run our images. You may either:
-
Generate an evaluation license obtained with a valid DevOps user key. For more information, see DevOps Registration.
-
Use a valid product license available with a current Ping Identity customer subscription after DevOps Registration completion.
Set Up Your DevOps Environment ¶
-
Open a terminal and create a local DevOps directory named
${HOME}/projects/devops
.Parent Directory
is the parent directory for all DevOps examples referenced in our documentation.
-
Configure your DevOps environment as follows.
pingctl config
-
Respond to all configuration questions, accepting the defaults if uncertain. Settings for custom variables aren't needed initially but may be necessary for additional capabilities.
-
All of your responses are recorded in your local
~/.pingidentity/config
file. Allow the configuration script to source this file in your shell profile (for example,~/.bash_profile
in a bash shell).
-
-
[Optional] Export configured pingctl variables as environment variables
- Modify your shell profile (for example,
~/.bash_profile
in a bash shell) so that the generatedsource ~/.pingidentity/config
command is surrounded byset -a
andset +a
statements.
set -a # Ping Identity - Added with 'pingctl config' on Fri Apr 22 13:57:04 MDT 2022 test -f '${HOME}/.pingidentity/config' && source '${HOME}/.pingidentity/config' set +a
- Verify configured variables are exported in your environment.
1. Restart your shell or source your shell profile. 2. Run `env | grep 'PING'`
- Modify your shell profile (for example,
-
To display your DevOps environment settings, enter:
pingctl info
-
To run a quick demonstration of any of our products in your environment, check out our Helm Basics or Kubernetes Basics documentation.
-
For more information on the variables available in
pingctl
see Configuration & Environment Variables.