{"id":21174193,"url":"https://github.com/bluehalo/yadda","last_synced_at":"2025-07-26T23:33:37.287Z","repository":{"id":57099430,"uuid":"75434038","full_name":"bluehalo/yadda","owner":"bluehalo","description":"Yet Another Docker Deployment Application","archived":false,"fork":false,"pushed_at":"2019-01-18T19:56:15.000Z","size":85,"stargazers_count":4,"open_issues_count":5,"forks_count":1,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-07-09T23:25:44.157Z","etag":null,"topics":["aws-dynamodb","aws-ecs","aws-lambda","cli","docker","dockerfile","nodejs-library"],"latest_commit_sha":null,"homepage":null,"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/bluehalo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-12-02T21:55:22.000Z","updated_at":"2021-11-10T19:38:52.000Z","dependencies_parsed_at":"2022-08-20T20:10:45.207Z","dependency_job_id":null,"html_url":"https://github.com/bluehalo/yadda","commit_stats":null,"previous_names":["asymmetrik/yadda"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/bluehalo/yadda","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluehalo%2Fyadda","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluehalo%2Fyadda/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluehalo%2Fyadda/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluehalo%2Fyadda/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bluehalo","download_url":"https://codeload.github.com/bluehalo/yadda/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluehalo%2Fyadda/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267264932,"owners_count":24061454,"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-07-26T02:00:08.937Z","response_time":62,"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":["aws-dynamodb","aws-ecs","aws-lambda","cli","docker","dockerfile","nodejs-library"],"created_at":"2024-11-20T16:53:42.981Z","updated_at":"2025-07-26T23:33:37.242Z","avatar_url":"https://github.com/bluehalo.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"yadda\n=====\n(Yet Another Docker Deployment Application)\n\n`yadda` is a command line tool for managing deploying a collection of\nmicroservices to AWS EC2 Container Service using a declarative syntax. Create a\nManifest file (and associated environment files) declaring your services and\njobs (one-time or periodic task), and `yadda` will handle building the required\ndocker images, pushing them to your AWS Elastic Container Registry, creating\nthe associated services and task definitions in ECS, and running periodic tasks\non a schedule.\n\n**Warning: Use of yadda will result in creating resources in AWS for which you\nbear the cost.**\n\nGetting Started\n================\n\nInstall\n--------\n\n`yadda` is installable via npm under the `asymmetrik` namespace.\n\n\t$ npm install -g @asymmetrik/yadda\n\nDeployment Center\n-----------------\n\nTo operate, `yadda` first must install a deployment center that handles the\ndeployment history of your application (enabling the `rollback` feature) and\nis responsible for running the jobs defined in your Manifest files.\n\nTo create the deployment center, run the following after installing `yadda`\n\n\t$ yadda create-deployment-center --region \u003cAWS_REGION\u003e \u003cDEPLOYMENT_CENTER_NAME\u003e\n\nreplacing `\u003cAWS_REGION\u003e` with the region you want the deployment center\ninstalled in and `\u003cDEPLOYMENT_CENTER_NAME\u003e` with the name you want to give this\ndeployment center.\n\nA single deployment center can be used to manage deployments across multiple\nAWS Regions (including managing deployments on ECS clusters outside of the\nregion where the Deployment Center is installed).\n\nAdditionally, a single deployment center can handle managing multiple different\napplications.\n\nManifest Files\n--------------\n\n`yadda` needs certain information to manage the deployments. This information is\nstored in a Manifest file for a given App and specific environment files for\neach deployment environment.\n\n`yadda` expects these files to be within the root directory of your App,\ninside a folder named `deployment`. An example folder structure is provided\nbelow.\n\n\tMyApp\n\t|- deployment\n\t\t|- Manifest.js\n\t\t|- env\n\t\t\t|- production.js\n\t\t\t|- staging.js\n\t\t\t|- dev.js\n\nTo create a skeleton for the required files, run\n\n\t$ yadda init\n\nwhich will create the deployment folder and skeleton files in the current\nworking directory.\n\nYou can find an full example under the `example` directory in this\nrepo. The example files will show the required information for configuring your\napplication.\n\nThe schema for the Manifest files can be found under `/config/manifest.js`.\n\nDeploying your application\n--------------------------\n\nAfter creating your Deployment Center and Manifest, you can deploy the\napplication via\n\n\t$ yadda deploy \u003cenvironment\u003e\n\nreplacing `\u003cenvironment\u003e` with the name of the environment you want to deploy to\n(for example, `yadda deploy staging` to deploy to the environment defined in\n`deployment/env/staging.js`).\n\nSecret Management\n--------------------------\n\nAfter your Deployment Center is created you can optionally create a secret center \nwhich your containers can leverage for encrypted secrets. See \n[Yadda-Secret](https://github.com/asymmetrik/yadda-secret) for the server package.\n\nTo create the Secret Center you can run  \n\n\t$ yadda create-secret-center \u003cenv\u003e\n\t\nThe command will create a secret center in the same region as your environments \ndeployment center. You can then access the secrets with\n\n\t$ yadda secret \u003cenv\u003e \u003caction\u003e \u003ckey\u003e [value]","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluehalo%2Fyadda","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbluehalo%2Fyadda","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluehalo%2Fyadda/lists"}