Deploy the laravel-octane helm chart on Rancher

Question

Pulumi · Accepted Answer

To deploy the Laravel Octane Helm chart on Rancher, you can use the rancher2 provider in Pulumi, which allows you to interact with and manage resources in a Rancher server. Helm charts can be deployed as applications within the Rancher2 provider. Below, you'll find a Pulumi TypeScript program that demonstrates how to do this.

Before you begin, make sure you have access to a running Rancher server, and you need to have administrative access to the Kubernetes cluster where you want to deploy the Laravel Octane application. You will also need to have Pulumi installed and setup to work with your Kubernetes and Rancher environment.

Here's a step-by-step guide on what the program does:

Import the Necessary Modules: We start by importing the modules we’ll be using from the Pulumi library and the Rancher2 provider.
Instantiate the Rancher2 Provider: Set up the Rancher2 provider with the necessary credentials to access your Rancher server.
Deploy the Laravel Octane Helm Chart: Deploy a new application to your Kubernetes cluster, specifying the Laravel Octane Helm chart and any necessary configuration values.

Now, let's go through the TypeScript program that deploys the Laravel Octane Helm chart on Rancher:

import * as pulumi from '@pulumi/pulumi';
import * as rancher2 from '@pulumi/rancher2';
import * as k8s from '@pulumi/kubernetes';

// Create a new rancher2 provider instance, allowing us to interact with Rancher
const rancher2Provider = new rancher2.Provider('my-rancher', {
    apiUrl: '<RANCHER_API_URL>', // Replace with your Rancher API URL
    accessKey: '<RANCHER_ACCESS_KEY>', // Replace with your Rancher access key
    secretKey: '<RANCHER_SECRET_KEY>', // Replace with your Rancher secret key
});

// Specify the namespace where you want to deploy your application
const namespaceName = 'octane';

// Create a Kubernetes namespace where the Helm chart will be deployed
const ns = new k8s.core.v1.Namespace(namespaceName, {
    metadata: {
        name: namespaceName,
    }
}, { provider: rancher2Provider });

// Deploy the Laravel Octane Helm chart as an application
const laravelOctaneApp = new rancher2.AppV2('laravel-octane-app', {
    // Update the following configuration with the details of your Rancher setup
    clusterId: '<CLUSTER_ID>', // Replace with your cluster ID.
    namespace: namespaceName,
    repoName: '<HELM_REPO_NAME>', // The name of the repository where Laravel Octane chart is hosted.
    chartName: 'laravel-octane', // Name of the Helm chart for Laravel Octane.
    chartVersion: '<CHART_VERSION>', // Define the version of the Laravel Octane chart you want to deploy.
    values: `
        // YAML formatted string or an object of values to be passed to the Helm chart.
        // For instance, to set a specific application environment, you could include:
        // app:
        //   environment: 'production'
    `,
}, { provider: rancher2Provider });

// Export the name of the namespace
export const namespaceNameExport = ns.metadata.name;

// After you deploy this Pulumi program, the Laravel Octane Helm chart will be
// deployed into the specified namespace on your Rancher-managed Kubernetes cluster.

Make sure to replace <RANCHER_API_URL>, <RANCHER_ACCESS_KEY>, <RANCHER_SECRET_KEY>, <CLUSTER_ID>, <HELM_REPO_NAME>, and <CHART_VERSION> with the actual values related to your Rancher setup and Laravel Octane Helm chart.

This program sets up the provider to interact with Rancher, creates a Kubernetes namespace for the application, and then deploys Laravel Octane within that namespace.

To run this program, save it in a file with a .ts extension, and then execute it with the Pulumi CLI, ensuring you've selected the right stack that connects to your Rancher environment:

pulumi up

The pulumi up command will review the infrastructure changes and prompt you to approve them before applying the changes to your Rancher cluster.

Remember, managing infrastructure as code requires understanding the implications of each change. Always review the plan from pulumi up before proceeding with the deployment.