Resources

Overview

Resources are any cloud resource that you want to manage with LaunchFlow. They can be anything from a Postgres Database to a Cloud Storage Bucket. LaunchFlow creates your resources in an environment and is only responsible for creating and destroying the resources. Once created you are free to update the resource however you like. Such as click-ops in the cloud console or using the cloud provider's CLI.

Creating Resources

CLI

We recommend the CLI approach if you are using LaunchFlow resources as part of backend system such as a web server.

First define your resources in a python file:

1
import launchflow as lf
2

3
bucket = lf.gcp.GCSBucket("my-bucket")
content_copy

Next run the following command from the root of your project to create the resources:

1
launchflow create
content_copy

This will scan your current directory to find any resources that need to create (or replaced) This will prompt you to select a project and environment to create the resource in. You can also specify the project and environment with the --project and --environment flags.

1
launchflow create main:bucket
content_copy

In Python Code

You can also use pure python if you don't want to use the CLI. We recommend this approach for things like scripts or notebooks.

To do this we wrap our resource definitions in the allow context manager. This will allow the resource to be created when you first run this block of code. Without this when you instantiate the bucket it would fail to connect since the resource does not yet exist.

Next we call create with a project and environment to create the resources.

1
import launchflow as lf
2

3
bucket = lf.gcp.GCSBucket("my-bucket")
4

5
bucket.create(project_name="project", resource_name="env")
6
bucket.connect()
content_copy

Deleting Resources

This will delete your service from LaunchFlow and turn down all cloud infrastructure associated with it. To delete an individual resource run:

1
launchflow resources delete \
2
  --project <project-name> \
3
  --environment <environment-name> \
4
  <resource-name>
content_copy

LaunchFlow can also automatically clean up unused resources that were previously part of your environment but are no longer used. To do this you can use launchflow clean. This takes in a list of active resources in your environment and will prompt you to delete any resources that are not in the list but are part of your environment. This is the opposite of launchflow create.

1
launchflow clean
content_copy

This will scan your directory to find all active resources and prompt to delete any resources that are not in the list but are part of your environment.

Listing Resources

1
launchflow resources list
content_copy