Skip to main content

A simple construct that executes a command locally. This is useful to run build steps within your CDKTF Program or to run a post action after a resource is created.

Project description

CDKTF Local Exec Construct

A simple construct that executes a command locally. This is useful to run build steps within your CDKTF Program or to run a post action after a resource is created.

The construct uses the null provider to achieve this so it can be trusted to only run after all dependencies are met.

Usage

import { Provider, LocalExec } from "cdktf-local-exec";

// LocalExec extends from the null provider,
// so if you already have the provider initialized you can skip this step
new Provider(this, "local-exec");

const frontend = new LocalExec(this, "frontend-build", {
  // Will copy this into an asset directory
  cwd: "/path/to/project/frontend",
  command: "npm install && npm build",
});

const pathToUpload = `${frontend.path}/dist`;

new LocalExec(this, "frontend-upload", {
  cwd: pathToUpload,
  command: `aws s3 cp --recursive ${pathToUpload} s3://${bucket.name}/frontend`,
});

new LocalExec(this, "backend-build", {
  cwd: "/path/to/project/backend",
  copyBeforeRun: false, // can not run remotely since the runner has no docker access
  command: "docker build -t foo . && docker push foo",
});

Options

  • cwd: The working directory to run the command in. It will be copied before execution to ensure the asset can be used in a remote execution environment.
  • command: The command to execute.
  • copyBeforeRun: If true, the command will copy the cwd directory into a tmp dir and run there. If false, the command will be executed in the cwd directory.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cdktf-local-exec-0.3.0.tar.gz (31.5 kB view details)

Uploaded Source

Built Distribution

cdktf_local_exec-0.3.0-py3-none-any.whl (29.9 kB view details)

Uploaded Python 3

File details

Details for the file cdktf-local-exec-0.3.0.tar.gz.

File metadata

  • Download URL: cdktf-local-exec-0.3.0.tar.gz
  • Upload date:
  • Size: 31.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for cdktf-local-exec-0.3.0.tar.gz
Algorithm Hash digest
SHA256 9abdedb433adcae995ce0a41f4c5d31d775f1975725a7abd0124befb6e7e1639
MD5 a13ba74d3544ed1a7429eac27de572e8
BLAKE2b-256 2790fb3167dbdb3f4671cf480934e8c672c8965c1d5aa90d80b5d4451a12d69e

See more details on using hashes here.

File details

Details for the file cdktf_local_exec-0.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for cdktf_local_exec-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b98911fb5e3ddad1d98b304628dadde7cd1ab4419dfd1a18ffccdf495bab92d5
MD5 52b197addf36ef5906342db1e7d51653
BLAKE2b-256 a797b62b7af247cd4e54733155d8b18fb376823728d1f83851c9ed04ac221898

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page