mpdev-reference.md

Setup

See installation instructions here.

Mpdev resources

The mpdev tool creates and updates artifacts defined by yaml configurations. The mpdev resource schema is inspired by the schema for kubernetes resources, where a resource type is uniquely specified by a kind and apiVersion.

Currently, the mpdev tool supports the following types of resources:

• DeploymentManagerAutogenTemplate
• DeploymentManagerTemplate.

See the Deployment Manager guide for how to configure these resources.

Commands

Start from preconfigured mpdev template

The pkg get command downloads a preconfigured mpdev template. mpdev pkg is a wrapper around kpt pkg.

mpdev pkg get https://github.com/GoogleCloudPlatform/marketplace-tools.git/examples/deployment-manager/autogen/singlevm mypackage

See the README in the downloaded template for next steps.

Optional: git commit mpdev template

Commit the package to git in order to track changes made when customizing the mpdev template.

git init && git add . && git commit -m "Initial clone"

Customize an mpdev template

The cfg set command can be used to programmatically customize values in a preconfigured mpdev template. mpdev cfg is a wrapper around kpt cfg.

mpdev cfg set mypackage/ projectId <PROJECT_ID>

Generate mpdev resources

The apply command creates resources from the mpdev template.

mpdev apply -f mypackage/configurations.yaml

The --dry-run option can be used to validate the schema of configuration files quickly without creating the mpdev resources.

mpdev apply --dry-run -f mypackage/configurations.yaml