Evergreen NodeJs serverless

Thanks for installing Evergreen nodejs serverless template. This developer guide will further give you insight into the template and additional steps you will need to take for your app development.

Template Features Evergreen serverless template comes with below features

• Built on top of ExpressJs / typescript.
• Comes built in with all cio compliant security headers that should be part of each http response.
• Has logging / telemetry features.
• Support Azure Ad eso authentication using Microsoft passport AD library.
• Support compile and packaging the solution using webpack / cio - bundler utility.
• Comes integrated with CI / CD pipeline yml that support all compliance, build, packaging and deploy stages e.g. code analysis, unit test execution, code coverage, security scans, build and deploy the app.
• Support IaC / TF modules for provisioning AWS API gateway and AWS lambda services in AWS bridge account.

Next steps / Actions for developer In this template you need to enables authentication if not done already. Onboard your API with ESO team, Please refer this link for details.

Once you have the eso details handy like clinet_id, scopes and audience then you will need to run msal schematics to enable authentication. The template code already have .npmrc file, you will need to get a personal access token (PAT) to install @rebar/serverless schematics npm package.

Please follow below steps -

• Go to the template root directory on the command prompt.

• Follow STEP 3 from this link for getting PAT for npm feed.

• Install rebar serverless evergreen package : run below command. npm install @rebar/serverless --no-save.

• Run below command to apply msal authentication npx schematics @rebar/serverless:msal Provide inputs like client_id , scopes and audience for your service.

Evergreen serverless has different schematics those are already executed by Cloud2.0 cartridge except msal schematics. But developer can further execute any of these schematics on an existing template if they want to update few configuration or just want to run a latest @rebar/serverless package commands to get new features.

Available schematics in @rebar/serverless package

1. @rebar/serverless:create
2. @rebar/serverless:rebar
3. @rebar/serverless:devops
4. @rebar/serverless:msal
5. @rebar/serverless:logging
6. @rebar/serverless:headers
7. @rebar/serverless:errorhandler
8. @rebar/serverless:telemetry

CI / CD Evergreen template comes with CI and CD yml files those have all required stages for app deployment to aws bridge account. CD process uses TF module developed by ICN team. During AWS bridge onboarding a variable groups gets created in your AzureDevOps library where all the variables created and auto managed like AWS_ACCESS_KEY, AWS_ACCOUNT_ID,AWS_REGION,APP_TEAM_DEPLOYER_ROLE etc.

The aws credential file are auto rotated during daily rotation process, So app team don't have to worry about the rotation. More on this can be found on this link.

Support / Feedback For further support / troubleshooting / feedback please reach out to Rebar App Arch team via below support channels -

• Post your messages to SE & A community Hub team channel.
• Create a service now Support ticket on this link
• Drop an email to [email protected]