@salesforce/plugin-evergreen-build
An SFDX CLI plugin for building and testing images for Salesforce Evergreen functions and services
Last updated 11 days ago by jgrantham .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @salesforce/plugin-evergreen-build 
SYNC missed versions from official npm registry.

SFDX CLI Evergreen Build plugin

An SFDX CLI plugin for building and testing images for Salesforce Evergreen functions and service.

Note: This feature is in beta and has been released early so we can collect feedback. It may contain significant problems, undergo major changes, or be discontinued. The use of this feature is governed by the Salesforce.com Program Agreement.

oclif CircleCI Version Downloads/week License

Table of contents

Usage

$ sfdx plugins:install @salesforce/plugin-evergreen-build
running command...
$ sfdx evergreen --help [COMMAND]
USAGE
  $ sfdx evergreen:COMMAND
...

Commands

sfdx evergreen:function:build IMAGE

build function source code into a deployable image

USAGE
  $ sfdx evergreen:function:build IMAGE

ARGUMENTS
  IMAGE  image name, must be in all lowercase

OPTIONS
  -e, --env=env          Build-time environment variable, in the form 'VAR=VALUE'or 'VAR'. When using latter value-less
                         form, value will be taken from current environment at the time this command is executed. This
                         flag may occur multiple times if more than one variable is desired.

  -p, --path=path        [default: .] path to function dir

  -v, --verbose          output raw build logs

  --buildpack=buildpack  Buildpack ID, path to a Buildpack directory, or path/URL to a Buildpack .tgz file. Repeat for
                         each buildpack in order.

  --clear-cache          Clear image's associated cache before building.

  --env-file=env-file    Build-time environment variables file comprised of one variable per line, of the form
                         'VAR=VALUE' or 'VAR' When using latter value-less form, value will be taken from current
                         environment at the time this command is executed.

  --network=network      Connect and build containers to a network. This can be useful to build containers which require
                         a local resource.

  --no-pull              Skip pulling builder and run images before use.

EXAMPLE

       $ sfdx evergreen:function:build image-repo/myfunction:dev
       $ sfdx evergreen:function:build image-repo/myfunction:dev --path /path/to/function/src
       $ sfdx evergreen:function:build image-repo/myfunction:dev --network host

See code: src/commands/evergreen/function/build.ts

sfdx evergreen:function:invoke URL

send a cloudevent to a function

USAGE
  $ sfdx evergreen:function:invoke URL

ARGUMENTS
  URL  The target url

OPTIONS
  -H, --headers=headers                set headers
  -p, --payload=payload                set the payload of the cloudevent. also accepts @file.txt format
  -u, --targetusername=targetusername  username or alias for the target org; overrides default target org
  --structured                         set the cloudevent to be emitted as a structured cloudevent (json)

EXAMPLE

       $ sfdx evergreen:function:invoke http://localhost:8080 -p '{"id": 12345}'
       $ sfdx evergreen:function:invoke http://localhost:8080 -p '@file.json'
       $ echo '{"id": 12345}' | sfdx evergreen:function:invoke http://localhost:8080
       $ sfdx evergreen:function:invoke http://localhost:8080 -p '{"id": 12345}' --structured

See code: src/commands/evergreen/function/invoke.ts

sfdx evergreen:function:start

build and run function image locally

USAGE
  $ sfdx evergreen:function:start

OPTIONS
  -e, --env=env      set environment variables
  -v, --verbose      output additional logs
  --builder=builder  set custom builder image

  --network=network  Connect and build containers to a network. This can be useful to build containers which require a
                     local resource.

EXAMPLE

       $ sfdx evergreen:function:start
       $ sfdx evergreen:function:start -e VAR=VALUE
       $ sfdx evergreen:function:start --network host

See code: src/commands/evergreen/function/start.ts

sfdx evergreen:image:push IMAGE

push an image to the registry

USAGE
  $ sfdx evergreen:image:push IMAGE

ARGUMENTS
  IMAGE  image name

OPTIONS
  -p, --project=project  project name
  -s, --space=space      (required) space name or space uuid

ALIASES
  $ sfdx evergreen:function:push

EXAMPLE

       $ sfdx evergreen:image:push image-repo/myfunction:dev --space=space-name --project=project-name
       $ sfdx evergreen:image:push image-repo/myfunction:dev --space=space-uuid

See code: src/commands/evergreen/image/push.ts

Using a different builder

  • Grab the desired version from here, go get -u github.com/heroku/builder/cmd/builder, or build it yourself.
  • export EVERGREEN_BUILDER_PATH=<path_to_built_binary>
  • Now you can run your sfdx commands that require a builder and it will use the provided builder instead of the one downloaded during plugin install.

Current Tags

  • 0.8.1                                ...           latest (11 days ago)

12 Versions

  • 0.8.1                                ...           11 days ago
  • 0.8.0                                ...           18 days ago
  • 0.7.1                                ...           a month ago
  • 0.7.0                                ...           2 months ago
  • 0.5.1                                ...           2 months ago
  • 0.6.0                                ...           2 months ago
  • 0.5.0                                ...           3 months ago
  • 0.4.2                                ...           3 months ago
  • 0.4.1                                ...           3 months ago
  • 0.4.0                                ...           3 months ago
  • 0.3.3                                ...           4 months ago
  • 0.3.2                                ...           4 months ago

Copyright 2014 - 2016 © taobao.org |