{"id":20904999,"url":"https://github.com/devopsartfactory/act","last_synced_at":"2025-10-12T21:38:58.516Z","repository":{"id":57596747,"uuid":"346188902","full_name":"DevopsArtFactory/act","owner":"DevopsArtFactory","description":"AWS Command Line Tool","archived":false,"fork":false,"pushed_at":"2021-10-14T01:35:07.000Z","size":48317,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-13T05:41:16.031Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DevopsArtFactory.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-03-10T00:57:12.000Z","updated_at":"2021-10-14T01:35:11.000Z","dependencies_parsed_at":"2022-09-26T19:53:25.220Z","dependency_job_id":null,"html_url":"https://github.com/DevopsArtFactory/act","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/DevopsArtFactory/act","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevopsArtFactory%2Fact","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevopsArtFactory%2Fact/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevopsArtFactory%2Fact/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevopsArtFactory%2Fact/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DevopsArtFactory","download_url":"https://codeload.github.com/DevopsArtFactory/act/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevopsArtFactory%2Fact/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279013123,"owners_count":26085232,"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","status":"online","status_checked_at":"2025-10-12T02:00:06.719Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-11-18T13:20:31.807Z","updated_at":"2025-10-12T21:38:58.485Z","avatar_url":"https://github.com/DevopsArtFactory.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# act\nact is a command line tool for developers who are using AWS Cloud. This command line interface will help you do work more easily and fast.\nYou can assume to the different AWS account or generate rds authentication token with one command.\n\n## Important Notice\n- For almost of commands, act will check whether the access key is expired or not (180 days)\n- If your access key is older than `180 days`, run `act renew-credential`.\n  - It will change your `aws_access_key_id` and `aws_secret_access_key` in $HOME/.aws/credentials.\n\n## Install\n* macOS user\n```bash\n$ brew tap DevopsArtFactory/devopsart\n$ brew install devopsartfactory/devopsart/ac\n$ act version -v info\n```\n\n* Linux user\n```bash\n$ curl -Lo act https://devopsartfactory.s3.ap-northeast-2.amazonaws.com/act/releases/latest/act-linux-amd64\n$ sudo install act /usr/local/bin/\n$ act version -v info\n```\n\n* Windows user\n  - file : https://devopsartfactory.s3.ap-northeast-2.amazonaws.com/act/releases/latest/act-windows-amd64.exe\n  - Simply download it and place it in your PATH as act.exe.\n  \n  \n ## Auto completion\n- zsh \n  - This is recommended.\n ```bash\n$ echo \"source \u003c(act completion zsh)\" \u003e\u003e ~/.zshrc\n$ source  ~/.zshrc\n```\n\n- bash \n ```bash\n$ echo \"source \u003c(act completion bash)\" \u003e\u003e ~/.bash_rc or ~/.bash_profile\n$ source  ~/.bashrc\n```\n\n## Setting Configuration\n- Configuration file should be in `$HOME/.aws/config.yaml`.\n- You can easily create your configuration file with `act init`\n- `act init` will create a configuration for default profile.\n```bash\n$ act init\n? Your base account:  gslee@gmail.com\n- profile: default\n  name: gslee@gmail.com\n  duration: 3600\n  assume_roles:\n    preprod: \"\"\n    prod: \"\"\n  databases:\n    preprod:\n    - \"\"\n    prod:\n    - \"\"\n\n? Are you sure to generate configuration file?  yes\nNew configuration file is successfully generated in $HOME//Users/gslee/.aws/config.yaml\n```\n\n## Alias for assume role\n- You can set alias with alias list.\n- **You cannot use `-` prefix for alias because golang will detect it as flag.**\n```bash\n$ vim ~/.aws/config.yaml\n- profile: default\n  name: gslee@gmail.com\n  alias:\n    d: preprod\n    p: prod\n  assume_roles:\n    preprod: arn:aws:iam::xxxxxxxxxxxx:role/userassume-devopsart-preprod-admin\n    prod: arn:aws:iam::xxxxxxxxxxx:role/userassume-devopsart-prod-admin\n\n# This is equal to `act setup preprod`\n$ act setup d\nAssume Credentials copied to clipboard, please paste it.\n```\n\n## RDS IAM Authentication\n- You can get RDS auth token in order to log in to the database.\n- If you follow these steps, then you will get your token in the clipboard\n\n```bash\n$ act get rds-token\n[preprod-aurora prod]\n? Choose the environment:   [Use arrows to move, type to filter]\n\u003e preprod-aurora\n  prod\n\n# If you select environment\n[preprod-aurora prod]\n? Choose the environment:  preprod-aurora\n? Choose an instance: wet  [Use arrows to move, type to filter]\n\u003e xxxxxxxxxxxxxxx.cluster-xxxxxxx.ap-northeast-2.rds.amazonaws.com\n  yyyyyyyyyyyyyyy.cluster-yyyyyyy.ap-northeast-2.rds.amazonaws.com\n  zzzzzzzzzzzzzzz.cluster-zzzzzzz.ap-northeast-2.rds.amazonaws.com\n\n# If you choose instance\n$ act get rds-token\n[preprod-aurora prod]\n? Choose the environment:  preprod-aurora\n? Choose an instance: xxxxxxxxxxxxxx.cluster-xxxxxxx.ap-northeast-2.rds.amazonaws.com\nAssume Role MFA token code: 712352\nINFO[0084] Token is copied to clipboard.\n```\n\n\n## Commands \n```bash\nAWS command line helper tool\n\nmanaging configuration of act\n  init             initialize act command line tool\n\ncommands related to aws IAM credentials\n  renew-credential recreates aws credential of profile\n\ncommands for controlling assume role\n  setup            create assume credentials for multi-account\n  who              check the account information of current shell\n\ncommands for retrieving information related to AWS WAF.\n  describe-web-acl retrieve detailed list of web acl\n  has-ip           check if ip is registered in the web acl\n\nOther Commands:\n  assume           do work about assume role\n  completion       Output shell completion for the given shell (bash or zsh)\n  ecr-login        login to ECR\n  get              Get token or information with act\n  version          Print the version information\n\nUsage:\n  act [flags] [options]\n\nUse \"act \u003ccommand\u003e --help\" for more information about a given command.\n```\n\n## Contribution Guide\n- Check [CONTRIBUTING.md](CONTRIBUTING.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevopsartfactory%2Fact","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevopsartfactory%2Fact","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevopsartfactory%2Fact/lists"}