Minikube Virtual Machine

This documentation describes the legacy CDK implementation, which will be deprecated in an upcoming release. We strongly recommend that you transition to the current CDK implementation as soon as possible.

Minikube is a tool that runs a single-node Kubernetes cluster in a virtual machine.

The following configuration has been validated for building custom Docker images for the ForgeRock Identity Platform using Minikube:

To set up Minikube:

  1. Use the minikube start command to create a Minikube VM. In this example, the Minikube VM is created with a Kubernetes cluster suitable for building custom Docker images for the ForgeRock Identity Platform:

    $ minikube start --memory=12288 --cpus=3 --disk-size=40g --cni=true --vm=true \
     --driver=virtualbox --bootstrapper kubeadm --kubernetes-version=stable 
    😄  minikube v1.23.2 on Darwin 11.5.1
    ✨  Using the virtualbox driver based on user configuration
    💿  Downloading VM boot image …​
        > minikube-v1.23.1.iso.sha256: 65 B / 65 B [-------------] 100.00% ? p/s 0s
        > minikube-v1.23.1.iso: 225.22 MiB / 225.22 MiB [ 100.00% 4.00 MiB p/s 1m2s
    👍  Starting control plane node minikube in cluster minikube
    🔥  Creating virtualbox VM (CPUs=3, Memory=12288MB, Disk=40960MB) …​
    🐳  Preparing Kubernetes on Docker 20.10.6 …​
        ▪ Generating certificates and keys …​
        ▪ Booting up control plane …​
        ▪ Configuring RBAC rules …​
    🔗  Configuring CNI (Container Networking Interface) …​
        ▪ Using image
    🌟  Enabled addons: default-storageclass, storage-provisioner
    🔎  Verifying Kubernetes components. . .
    🏄  Done! kubectl is now configured to use "minikube" by default
  2. Run the following command to enable the ingress controller built into Minikube:

    $ minikube addons enable ingress
        ▪ Using image
        ▪ Using image
        ▪ Using image
    🔎  Verifying ingress addon…​
    🌟  The 'ingress' addon is enabled
  3. Install the Secret Agent operator:

    $ kubectl apply -f
    namespace/secret-agent-system created created
    serviceaccount/secret-agent-manager-service-account created created created created created
    service/secret-agent-webhook-service created
    deployment.apps/secret-agent-controller-manager created
    Warning: MutatingWebhookConfiguration is deprecated in v1.16+, unavailable in v1.22+; use MutatingWebhookConfiguration created
    Warning: ValidatingWebhookConfiguration is deprecated in v1.16+, unavailable in v1.22+; use ValidatingWebhookConfiguration created

Next Step

Copyright © 2010-2024 ForgeRock, all rights reserved.