1. Docs
  2. Pulumi ESC
  3. Environment Definition Reference
  4. Top-Level Keys
  5. imports

imports

    The imports top-level key is a list of other environments that this environment imports. Imported environments are evaluated and merged to form the basis for the current environment, which is then evaluated and merged with the imported values. Merging is performed using the JSON Merge Patch algorithm.

    Environment names

    Each entry in the imports list names an environment to import. Environment names should be qualified with a project (e.g. my-project/dev). If no project name is given, the default project is assumed (e.g. the unqualified name foo refers to default/foo):

    imports:
      - auth-core          # Imports the "auth-core" environment in the "default" project
      - network-infra/dev  # Imports the "dev" environment in the "network-infra" project
    

    Import options

    It is sometimes desirable to control the behavior of an import. This can be done using import options:

    imports:
      - auth-core: { merge: false } # Import "default/auth-core", but don't add it to the merge stack
    

    There is currently a single option, merge, which controls whether or not an imported environment is added to the merge stack. Unmerged imports are still available via the imports built-in key.

      PulumiUP May 6, 2025. Register Now.