@totallymoney/github-serverless-dotnet-artifacts
v4.0.7
Published
Use github releases to publish and deploy serverless framework dotnet projects
Downloads
332
Keywords
Readme
github serverless dotnet artifacts
Publish and deploy serverless dotnet projects using github managed artifacts.
Serverless packaging is performed correctly.
Requirements
yarn
,gh
&dotnet
are available on the command lineAmazon.Lambda.Tools
dotnet tool is installed in the target dotnet repo:
$ dotnet new tool-manifest
$ dotnet tool install Amazon.Lambda.Tools
Usage
- Install
$ yarn add -D @totallymoney/github-serverless-dotnet-artifacts
- Specify this package location in your
serverless.yml
package:
artifact: package.zip
- Add a
publish
step to your CI pipeline to create a github release
$ yarn run gsda-publish $VERSION [ -p path/to/project ]
$VERSION
is the github release name in semver format-p
is optional with a default value of./src
- Use the
deploy
command to update an enviroment
$ yarn run gsda-deploy $VERSION $ENVIRONMENT
$VERSION
is the github release to deploy$ENVIRONMENT
is the target environment (aka serverless 'stage')
- Add a helper script to your
package.json
and usepick
for interactive deployments!
"scripts": {
"pick": "gsda-pick -e stage -e prod -c 5"
}
$ yarn pick
-e
(multiple) are preset environments forpick
-c
is the version list count forpick
- both
-e
and-c
have sensible defaults and can be overridden whenpick
is called
Development
Make sure you belong to the totallymoney npm organization. Then make changes to the source code and publish. Enter the new version number as prompted. A git push command will run automatically after publishing.
$ git commit -am "Improve logging"
$ yarn publish --access public
Migrating from 3.x.x to 4.x.x
github cli is required on your machine.
$ brew install gh # start interactive setup $ gh auth login
The
deploy
&publish
npm scripts are now obselete.Even in 3.x.x, these commands only existed as a level of indirection to centralize input that could be called from more than one place and be burdensome to type. These commands are now less of a burden because the
gh
cli automatically recognises the repo it is operating on. We no longer need to "pin" the repo name withdeploy
&publish
indirection commands, and can instead go straight togsda-deploy|publish
. We should, however, favourgsda-pick
to manually deploy from the command line overgsda-deploy
.gsda-pick
now usesgsda-deploy
internally, and no longer expectsdeploy
to exist.The positional arguments of
gsda-deploy
remain the same: version, then target environment. So ifdeploy
is called by CI tooling, the only change required is to usegsda-deploy
instead.The removal of
publish
also avoids any confusion caused by "squatting" on the existing (npm|yarn)publish
command.The project path of the
gsda-publish
command is provided via the optional-p
flag.If not specified, the project path defaults to
./src
which is the case for most projects. The version argument is still the first positional argument expected bygsda-publish
. The command should be called directly from CI tooling, and called directly from the command line if ever needed outside of a CI context.The commit hash positional argument to the
gsda-publish
command is obselete.Again,
gh
understands the context and will create a release from the current state of the repo, which will be checked out at the commit we wish to tag.If building with CircleCI the github-cli orb is required.
package.json
"devDependencies": { - "@totallymoney/github-serverless-dotnet-artifacts": "^3.2.0", + "@totallymoney/github-serverless-dotnet-artifacts": "^4.0.0", }, "scripts": { - "publish": "gsda-publish org/repo proj/path", - "deploy": "gsda-deploy org/repo", }
.github/workflows/build.yml
- if: github.ref == 'refs/heads/main' - run: yarn run publish $VERSION $GITHUB_SHA + run: yarn run gsda-publish $VERSION -p proj/path env: - GITHUB_OAUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} VERSION: 0.0.${{ github.run_number }}
.circleci/config.yml
+ orbs: + github-cli: circleci/[email protected] - when: condition: equal: [ << pipeline.git.branch >>, main ] steps: + - github-cli/setup: + token: GITHUB_OAUTH_TOKEN - run: - command: yarn run publish $VERSION $CIRCLE_SHA1 + command: yarn run gsda-publish $VERSION -p proj/path environment: VERSION: 0.0.<< pipeline.number >>