{"id":21847538,"url":"https://github.com/scribd/amazon-appmesh-virtual-node-action","last_synced_at":"2025-03-21T17:20:00.603Z","repository":{"id":36953348,"uuid":"397740819","full_name":"scribd/amazon-appmesh-virtual-node-action","owner":"scribd","description":"Amazon App Mesh Virtual Node Action for GitHub Actions","archived":false,"fork":false,"pushed_at":"2023-06-30T09:21:28.000Z","size":3368,"stargazers_count":1,"open_issues_count":6,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-21T18:36:42.659Z","etag":null,"topics":["appmesh","aws","github-actions"],"latest_commit_sha":null,"homepage":"https://github.com/scribd/amazon-appmesh-virtual-node-action","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/scribd.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null}},"created_at":"2021-08-18T21:37:26.000Z","updated_at":"2022-05-31T23:07:05.000Z","dependencies_parsed_at":"2023-01-17T08:01:06.877Z","dependency_job_id":null,"html_url":"https://github.com/scribd/amazon-appmesh-virtual-node-action","commit_stats":{"total_commits":172,"total_committers":3,"mean_commits":"57.333333333333336","dds":0.6162790697674418,"last_synced_commit":"ccdd057ccf05ee4d0ac671758f01d3fc7c012d92"},"previous_names":[],"tags_count":95,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scribd%2Famazon-appmesh-virtual-node-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scribd%2Famazon-appmesh-virtual-node-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scribd%2Famazon-appmesh-virtual-node-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scribd%2Famazon-appmesh-virtual-node-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/scribd","download_url":"https://codeload.github.com/scribd/amazon-appmesh-virtual-node-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244835574,"owners_count":20518263,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["appmesh","aws","github-actions"],"created_at":"2024-11-27T23:18:30.041Z","updated_at":"2025-03-21T17:20:00.571Z","avatar_url":"https://github.com/scribd.png","language":"JavaScript","readme":"## Amazon App Mesh Virtual Node Action for GitHub Actions\n\n[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)\n\nCreates an Amazon App Mesh Virtual Node\n\n**Table of Contents**\n\n\u003c!-- toc --\u003e\n\n- [Amazon App Mesh Virtual Node Action for GitHub Actions](#amazon-app-mesh-virtual-node-action-for-github-actions)\n- [Usage](#usage)\n  - [Creating the resource](#creating-the-resource)\n  - [Deleting the resource](#deleting-the-resource)\n- [Credentials and Region](#credentials-and-region)\n- [Permissions](#permissions)\n- [Troubleshooting](#troubleshooting)\n\n\u003c!-- tocstop --\u003e\n\n## Usage\n\n### Creating the resource\n\n```yaml\n- name: App Mesh Virtual Node\n  uses: scribd/amazon-appmesh-virtual-node-action@v1\n  with:\n    name: my-virtual-node\n    mesh-name: my-mesh-name\n    spec: |\n      {\n        \"httpRoute\": {\n          \"action\": {\n              \"weightedTargets\": [\n                  {\n                      \"virtualNode\": \"my-virtual-node\",\n                      \"weight\": 1\n                  }\n              ]\n          },\n          \"match\": {\n              \"prefix\": \"/\"\n          }\n        }\n      }\n    tags: |\n      [\n        {\n          \"key\": \"tags-must\",\n          \"value\": \"be-passed-in-as-a-json-string\"\n        },\n        {\n          \"key\": \"this-is-because\",\n          \"value\": \"GitHub Actions translates these values into Environment Variables\"\n        }\n      ]\n```\n### Deleting the resource\n\nDeleting the resource requires `name`, `mesh-name`, and `action` to be specified as `delete`. `mesh-owner` may be supplied if required. Any additional parameters will be ignored.\n\n```yaml\n- name: App Mesh Virtual Node\n  uses: scribd/amazon-appmesh-virtual-node-action@v1\n  with:\n    name: my-virtual-node\n    mesh-name: my-mesh-name\n    action: delete\n```\n\nSee [action.yml](action.yml) for the full documentation for this action's inputs and outputs.\n\n\n## Credentials and Region\n\nThis action relies on the [default behavior of the AWS SDK for Javascript](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html) to determine AWS credentials and region.\nUse [the `aws-actions/configure-aws-credentials` action](https://github.com/aws-actions/configure-aws-credentials) to configure the GitHub Actions environment with environment variables containing AWS credentials and your desired region.\n\nWe recommend following [Amazon IAM best practices](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) for the AWS credentials used in GitHub Actions workflows, including:\n* Do not store credentials in your repository's code.  You may use [GitHub Actions secrets](https://help.github.com/en/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets) to store credentials and redact credentials from GitHub Actions workflow logs.\n* [Create an individual IAM user](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#create-iam-users) with an access key for use in GitHub Actions workflows, preferably one per repository. Do not use the AWS account root user access key.\n* [Grant least privilege](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege) to the credentials used in GitHub Actions workflows.  Grant only the permissions required to perform the actions in your GitHub Actions workflows.  See the Permissions section below for the permissions required by this action.\n* [Rotate the credentials](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#rotate-credentials) used in GitHub Actions workflows regularly.\n* [Monitor the activity](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#keep-a-log) of the credentials used in GitHub Actions workflows.\n\n## Permissions\n\nThis action requires the following minimum set of permissions:\n\n```json\n{\n  \"Version\":\"2012-10-17\",\n  \"Statement\":[\n    {\n      \"Sid\":\"DeployNode\",\n      \"Effect\":\"Allow\",\n      \"Action\":[\n        \"appmesh:DescribeVirtualNode\",\n        \"appmesh:DeleteGatewayRoute\",\n        \"appmesh:CreateVirtualNode\"\n      ],\n      \"Resource\":[\n        \"arn:aws:appmesh:us-east-1:1234567890:mesh/my-mesh-name/virtualNode/my-virtual-node\"\n      ]\n    }\n  ]\n}\n```\n\n\n## Troubleshooting\n\nThis action emits debug logs to help troubleshoot deployment failures.  To see the debug logs, create a secret named `ACTIONS_STEP_DEBUG` with value `true` in your repository.\n\nTo run this action from your workstation, you should supply your environment variables with the `env` command, since BASH will (correctly) refuse to set environment variables with dashes in them.\n\nIf submitting an issue, please include output styled after the following example, it'll help greatly! Don't forget to redact any sensitive data from your submission.\n\nSee this example:\n\n```bash\nenv 'ACTIONS_STEP_DEBUG=true' \"GITHUB_WORKSPACE=$(pwd)\" 'AWS_REGION=us-east-1' 'INPUT_SPEC={\"a\": \"b\", \"c\": [{\"d\": \"e\"}]}' 'INPUT_MESH-NAME=example-mesh' 'INPUT_NAME=my-service' 'INPUT_TAGS=[{\"Key\": \"hello\", \"Value\": \"world\"}]' node  index.js\n```\n\n# Development\n\nReleases are cut using [semantic-release](https://github.com/semantic-release/semantic-release).\n\nPlease write commit messages following [Angular commit guidelines](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#-git-commit-guidelines)","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscribd%2Famazon-appmesh-virtual-node-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscribd%2Famazon-appmesh-virtual-node-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscribd%2Famazon-appmesh-virtual-node-action/lists"}