Configure Application

Configure BuildKit Endpoint

Before creating the GitHub app, you need to configure the BuildKit endpoint in the database:

⚠️

Set the HELM_RELEASE environment variable to your actual Helm release name before running the commands below.

The following commands will create the buildkit object and endpoint configuration if they don’t exist, or update them if they do.

Option 1: Using kubectl exec with psql

Execute the following commands to connect to the PostgreSQL pod and run the query:

Option 2: Direct SQL query

If you have direct database access, run the following SQL query (replace <YOUR-HELM-RELEASE> with your actual Helm release name):

Refresh Configuration Cache

After running either option above, refresh the configuration cache:

Replace <your_domain> with your actual domain (e.g., 0env.com).

Create GitHub App

To create a Github app that will send events to the Lifecycle with necessary permissions, follow these steps:

Make sure you have admin access to the Github organization or account where you want to create the app.

Navigate to your installed Lifecycle app at https://app.<your_domain>/setup (replace <your_domain> with your actual domain. e.g. https://app.0env.com/setup).
Select Personal or Organization based on your needs.
Fill in the required fields:
- Github App Name: A name for your app. (should be unique, use a prefix with your name or organization. Refer Github app naming convention here
- Organization Name: Github organization name where the app will be created. Required if you selected Organization.
Click Create App
On the Github app creation page, confirm the app name and click Create
Once the app is created, you will be redirected to the app installation page where you can choose one or more repositories to install the the newly minted app.

Make sure to select the repositories you want the app to have access to. You can always change this later in the app settings but adding atleast one repository is required to proceed with the setup.
Voila! 🎉 Your Github app is now created and installed.

Click Configure and Restart to apply the changes and start using the app.

The step above, sets up the global config values that Lifecycle app will use creating ephemeral environments and processing pull requests. And restarts the deployment for the github app secrets to take effect.

Let’s move on the final step where we will configure the Lifecycle app config for processing pull requests and creating ephemeral environments.

Install Lifecycle Additional Configuration