{"id":13416596,"url":"https://github.com/azukiapp/azk","last_synced_at":"2025-03-15T00:31:14.651Z","repository":{"id":10745652,"uuid":"13003799","full_name":"azukiapp/azk","owner":"azukiapp","description":"azk is a lightweight open source development environment orchestration tool. Instantly \u0026 safely run any environment on your local machine.","archived":true,"fork":false,"pushed_at":"2019-04-26T07:30:01.000Z","size":11889,"stargazers_count":898,"open_issues_count":100,"forks_count":63,"subscribers_count":34,"default_branch":"master","last_synced_at":"2024-07-31T21:57:15.513Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://azk.io","language":"JavaScript","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/azukiapp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/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":"2013-09-21T23:02:55.000Z","updated_at":"2024-06-25T16:57:40.000Z","dependencies_parsed_at":"2022-09-11T16:31:46.818Z","dependency_job_id":null,"html_url":"https://github.com/azukiapp/azk","commit_stats":null,"previous_names":[],"tags_count":48,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azukiapp%2Fazk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azukiapp%2Fazk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azukiapp%2Fazk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azukiapp%2Fazk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azukiapp","download_url":"https://codeload.github.com/azukiapp/azk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243667745,"owners_count":20328032,"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-07-30T21:01:01.710Z","updated_at":"2025-03-15T00:31:13.419Z","avatar_url":"https://github.com/azukiapp.png","language":"JavaScript","funding_links":[],"categories":["Development with Docker","Orchestration","JavaScript"],"sub_categories":["Wrappers","Visual Studio Code"],"readme":"# azk [![Gitter](https://badges.gitter.im/Join Chat.svg)](https://gitter.im/azukiapp/azk?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge) [![Code Climate](https://codeclimate.com/github/azukiapp/azk/badges/gpa.svg)](https://codeclimate.com/github/azukiapp/azk)\n\n### A development environment orchestration tool\n\n`azk` lets developers easily and quickly install and configure their development environments. Period.\n\n![Usage of azk](https://github.com/azukiapp/azk/blob/master/src/pres/azk-screenflow-slow.gif?raw=true)\n\n## Quick start\n\n### Installing\n\n```\n$ curl -Ls http://azk.io/install.sh | bash\n```\n\nRequirements:\n\n* **Mac OS X:** [VirtualBox](https://www.virtualbox.org/), version 4.3.6+\n* **Linux:** [Docker][docker], version 1.2+\n\nFor further details, please see the [docs](http://docs.azk.io/en/installation/index.html).\n\n### Using `azk`\n\n#### Starting a new project\n\nIf you are starting a new application project, you can already use `azk` to obtain the proper runtime as well the corresponding generators for your chosen language and then generate the application's basic structure. An example in Node.js would look like this:\n\n```bash\n$ cd ~/projects\n$ azk shell --image azukiapp/node # obtaining the runtime\n    # mkdir app-name\n    # npm init                    # building the application's basic structure\n    ...\n    # exit\n$ cd app-name\n$ azk init\nazk: `node` system was detected at 'app-name'\nazk: 'Azkfile.js' generated\n\n$ azk start\n```\n\n#### Using `azk` with an existing project\n\nWhen you have an application project that's already started, and want to use `azk` to streamline its development environment, all you have to do is:\n\n```bash\n$ cd [my_application_folder]\n$ azk init\nazk: 'Azkfile.js' generated\n...\n$ azk start\n```\n\n## Main features\n\n* Multiplatform: Works both on Linux \u0026 Mac OS X (requires 64-bit platform);\n  * Windows planned. Want azk to run in Windows? Thumbs up here: https://github.com/azukiapp/azk/issues/334\n* Images: via [azk images][azk_images], [Docker Registry][docker_registry] or run your own Dockerfile;\n* Built-in load-balancer;\n* Built-in file sync;\n* Automatic start-up (and reload) script;\n* Logging;\n* And simple and easy to use DSL to describe systems architecture;\n\n## Documentation\n\nYou can find our documentation online at: http://docs.azk.io/\n\n## `Run Project` button\n\nClicking the `Run Project` button (or \"azk button\") on a GitHub repo is the best way to quickly and safely run its code on your local machine.\n\n![Run project](https://s3-sa-east-1.amazonaws.com/assets.azk.io/run-project-illustrative.png)\n\nTo add a `Run Project` button to a repo, you'll just need to add an Azkfile.js to the project and put the following badge in your README.md file (the following example is for a hypothetical repository with the URL `https://github.com/username/repo` and a branch called `azkfile` containing the Azkfile.js):\n\n```\n[![Run project](https://s3-sa-east-1.amazonaws.com/assets.azk.io/run-project.png)](http://run.azk.io/start/?repo=username/repo\u0026ref=azkfile)\n```\n\nCheck out the [`Run Project` Gallery][run_project_gallery] for examples of up to date forks of popular projects using it.\n\n## Deploying\n\nAfter you locally run a project using [`Run Project` button](#run-project-button), deploying it to [DigitalOcean](http://digitalocean.com/) is very simple.\n\nFirst, put your [personal access token](https://cloud.digitalocean.com/settings/applications) into a `.env` file:\n\n```bash\n$ cd path/to/the/project\n$ echo \"DEPLOY_API_TOKEN=\u003cYOUR-PERSONAL-ACCESS-TOKEN\u003e\" \u003e\u003e .env\n```\n\nThen, just run the following:\n\n```bash\n$ azk shell deploy\n```\n\nFind further instructions on how to deploy to DigitalOcean using `azk` [here](http://docs.azk.io/en/deploy/README.html).\n\n### Basic Vocabulary\n\n#### System of Systems\n\n`azk` is based on the concept of [System of Systems][sos]. Accordingly, applications (your code), services and workers (such as databases, webservers and queue systems) are treated as systems that communicate with each other and together make the primary system. Using this paradigm, `azk` installs and manages development environments. While this may seem overkill at first, it actually makes it a lot easier to manage the development and execution environments of an application (in its parts - the \"systems\" - or in its entirety - the full \"system of systems\").\n\n#### Images\n\nIn order to automate the provisioning of development environments, `azk` uses pre-built custom images. These images follow the [Docker][docker] standard and can be found in: [azk images][azk_images], [Docker Index][docker_hub] or [Dockerfile][dockerfile].\n\n#### Azkfile.js\n\n`Azkfile.js` files are the cornerstone of how to use `azk`. These simple manifest files describe the systems that make your system of systems as well as the images used in their execution. They also describe parameters and execution options.\n\nMore information [here][azkfile].\n\n## Contributions\n\nCheck our [Contributing Guide](.github/CONTRIBUTING.md) for instructions on how to help the project!\n\nShare the love and star us here in Github!\n\n## License\n\n\"Azuki\", \"azk\" and the Azuki logo are copyright (c) 2013-2016 Azuki Serviços de Internet LTDA.\n\n**azk** source code is released under Apache 2 License.\n\nCheck LEGAL and LICENSE files for more information.\n\n[sos]: http://en.wikipedia.org/wiki/System_of_systems\n[docker]: http://docker.com\n[azk_images]: http://images.azk.io\n[docker_hub]: https://registry.hub.docker.com/\n[dockerfile]: http://dockerfile.github.io\n[docker_registry]: http://registry.hub.docker.com\n[azkfile]: http://docs.azk.io/en/azkfilejs/README.html\n[run_project_gallery]: https://github.com/run-project/gallery\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazukiapp%2Fazk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazukiapp%2Fazk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazukiapp%2Fazk/lists"}