{"id":16922884,"url":"https://github.com/unasuke/maekawa","last_synced_at":"2025-04-11T17:00:22.886Z","repository":{"id":64304312,"uuid":"81913695","full_name":"unasuke/maekawa","owner":"unasuke","description":"AWS CloudWatch Events cli client","archived":false,"fork":false,"pushed_at":"2017-06-14T05:55:20.000Z","size":160,"stargazers_count":18,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-25T13:02:06.824Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","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/unasuke.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-02-14T06:37:26.000Z","updated_at":"2023-04-14T09:13:07.000Z","dependencies_parsed_at":"2023-01-15T10:15:17.628Z","dependency_job_id":null,"html_url":"https://github.com/unasuke/maekawa","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unasuke%2Fmaekawa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unasuke%2Fmaekawa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unasuke%2Fmaekawa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unasuke%2Fmaekawa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unasuke","download_url":"https://codeload.github.com/unasuke/maekawa/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248446642,"owners_count":21105130,"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":[],"created_at":"2024-10-13T19:57:03.342Z","updated_at":"2025-04-11T17:00:22.850Z","avatar_url":"https://github.com/unasuke.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# maekawa\n[![Build Status](https://travis-ci.org/unasuke/maekawa.svg?branch=master)](https://travis-ci.org/unasuke/maekawa)\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/0adc1c0207354db9948fea0ea4cf8e98)](https://www.codacy.com/app/unasuke/maekawa?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=unasuke/maekawa\u0026amp;utm_campaign=Badge_Grade)\n\nMaekawa is a cli client for AWS CloudWatch Events has idempotence.\n\nJapanese version is under the English version.\n(日本語のREADMEが英語の下にあります)\n\n## how to install\nDownload latest binary for your archtecture from releaase page.\n\nhttps://github.com/unasuke/maekawa/releases\n\nAnd put that in your `$PATH` directory.\n\nOr, run this.\n\n```shell\n$ go get github.com/unasuke/maekawa\n```\n\n### macOS\nIf you using macOS and homebrew, you can install maekawa this command.\n\n```shell\n$ brew install unasuke/maekawa/maekawa\n```\n\n## usage\n### 1. install awscli and run `aws configure`\n- [Installing the AWS Command Line Interface - AWS Command Line Interface](http://docs.aws.amazon.com/cli/latest/userguide/installing.html)\n- [Configuring the AWS Command Line Interface - AWS Command Line Interface](http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)\n\n### 2. edit `config.yml`\n```yaml\nrules:\n  -\n    description: Execute every 5 minutes\n    event_pattern:\n    name: EveryFiveMinutes\n    role_arn:\n    schedule_expression: \"cron(0/5 * * * ? *)\"\n    state: ENABLED\n    targets:\n      -\n        arn: arn:aws:lambda:ap-northeast-1:000000000000:function:some-lambda-function\n        id: 05c99eea-4059-4294-8583-bb2d00df4226\n        input:\n        input_path:\n  -\n    name: TestEvent\n    schedule_expression: \"rate(2 day)\"\n    state: ENABLED\n    targets:\n      -\n        arn: arn:aws:lambda:ap-northeast-1:000000000000:function:another-lambda-function\n        id: 4c4d91c5-5f8b-4d5f-b28f-3fac49c835ad\n        input: |\n          { \"input\": \"json input\" }\n        input_path:\n      -\n        arn: arn:aws:lambda:ap-northeast-1:00000000000:function:another-lambda-function\n        id: 3bde837b-3093-487c-9328-a677e05ae75d\n        input: |\n          { \"input\": \"some input\" }\n        input_path:\n```\n\nMore example's in [sample.yml](https://github.com/unasuke/maekawa/blob/master/sample.yml).\n\n### 3. run maekawa\n```shell\n$ maekawa --region=ap-northeast-1 --apply --dry-run # check what will changes\n$ maekawa --region=ap-northeast-1 --apply # apply config.yml\n```\n\n## options\n### --region\nSpecify aws region.\nIf set env `AWS_REGION`, use this. But, `--region` option is override env.\n\n### --profile\nSpecify aws profile.\nIf set env `AWS_PROFILE`, use this. But, `--profile` option is override env.\n\n### --apply\nApply your config to AWS CloudWatch Events.\n\n### --dry-run\nShow what will changes without apply.\n\n### --file, -f\nSpecify config file path. (default `config.yml`)\n\n### --help, -h\nShow options.\n\n## License\nThis software is licensed under the MIT License. Please see the LICENSE.txt file for details.\n\n### aws-sdk-go\nThe aws-sdk-go is distributed under the Apache License 2.0.\n\nhttps://github.com/aws/aws-sdk-go\n\n### yaml\nThe yaml package is distributed under the Apache License 2.0.\n\nhttps://github.com/go-yaml/yaml\n\n-----------------------------------\n\n# maekawa\nmaekawaは冪等性を持つAWS CloudWatch Eventsのcli clientです。\n\n## インストール方法\n最新版リリースの、適したアーキテクチャ向けのバイナリをreleaseページからダウンロードしてください。\n\nhttps://github.com/unasuke/maekawa/releases\n\nその後、ダウンロードしたバイナリを`$PATH`の通っている場所に置いてください。\n\nもしくは、以下のコマンドを実行してください。\n\n```shell\n$ go get github.com/unasuke/maekawa\n```\n\n### macOS\nもしmacOSとhomebrewを使用している場合、次のコマンドでもインストールできます。\n\n```shell\n$ brew install unasuke/maekawa/maekawa\n```\n\n## 使い方\n### 1. awscliのインストールと `aws configure`の実行\n- [Installing the AWS Command Line Interface - AWS Command Line Interface](http://docs.aws.amazon.com/cli/latest/userguide/installing.html)\n- [Configuring the AWS Command Line Interface - AWS Command Line Interface](http://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)\n\n### 2. `config.yml`を編集する\n```yaml\nrules:\n  -\n    description: Execute every 5 minutes\n    event_pattern:\n    name: EveryFiveMinutes\n    role_arn:\n    schedule_expression: \"cron(0/5 * * * ? *)\"\n    state: ENABLED\n    targets:\n      -\n        arn: arn:aws:lambda:ap-northeast-1:000000000000:function:some-lambda-function\n        id: 05c99eea-4059-4294-8583-bb2d00df4226\n        input:\n        input_path:\n  -\n    name: TestEvent\n    schedule_expression: \"rate(2 day)\"\n    state: ENABLED\n    targets:\n      -\n        arn: arn:aws:lambda:ap-northeast-1:000000000000:function:another-lambda-function\n        id: 4c4d91c5-5f8b-4d5f-b28f-3fac49c835ad\n        input: |\n          { \"input\": \"json input\" }\n        input_path:\n      -\n        arn: arn:aws:lambda:ap-northeast-1:00000000000:function:another-lambda-function\n        id: 3bde837b-3093-487c-9328-a677e05ae75d\n        input: |\n          { \"input\": \"some input\" }\n        input_path:\n```\n\n[sample.yml](https://github.com/unasuke/maekawa/blob/master/sample.yml)に他の例があります。\n\n### 3. maekawaを実行する\n```shell\n$ maekawa --region=ap-northeast-1 --apply --dry-run # 変更部分の確認\n$ maekawa --region=ap-northeast-1 --apply # config.ymlの内容を適用\n```\n\n## オプション\n### --region\nAWS regionを指定します。\n環境変数に`AWS_REGION`が存在する場合それを使用しますが、`--region`が指定された場合はそちらで上書きます。\n\n### --profile\nAWS profileを指定します。\n環境変数に`AWS_PROFILE`が存在する場合それを使用しますが、`--profile`が指定された場合はそちらで上書きます。\n\n### --apply\nconfigに記述された内容をAWS CloudWatch Eventsに適用します。\n\n### --dry-run\n適用をせずに、何が変更されるかを確認します。\n\n### --file, -f\nconfigファイルのpathを指定します。 (デフォルトは `config.yml`です)\n\n### --help, -h\nオプションの一覧を表示します。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funasuke%2Fmaekawa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funasuke%2Fmaekawa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funasuke%2Fmaekawa/lists"}