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.4.5.tar.gz (31.8 kB view details)

Uploaded Source

Built Distribution

cdktf_local_exec-0.4.5-py3-none-any.whl (30.2 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for cdktf-local-exec-0.4.5.tar.gz
Algorithm Hash digest
SHA256 351cf84c0344057cbddba92dddce8c7f4014bff6c816c5ad88d11aa1b39029b1
MD5 6b4631f61c093385cc0e0f29cddb002c
BLAKE2b-256 fcb63403fbd58f6c685c64f988ea1d5de628245f227971747a5b4cac719cc892

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for cdktf_local_exec-0.4.5-py3-none-any.whl
Algorithm Hash digest
SHA256 78258f8f5b832c96f5fe58e1a48a0ecbfed3303673d7ca61d88ff55379e3e1d9
MD5 810ffed1aeb39c57c90e6dd6b3883443
BLAKE2b-256 27ca9e524b88d751509fc3cb9a78a828f6701a78ca9cae2b1ec42eb14e680512

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