{"id":13586206,"url":"https://github.com/elasticluster/elasticluster","last_synced_at":"2025-04-07T14:34:02.867Z","repository":{"id":7548549,"uuid":"8901369","full_name":"elasticluster/elasticluster","owner":"elasticluster","description":"Create clusters of VMs on the cloud and configure them with Ansible.","archived":false,"fork":false,"pushed_at":"2023-09-11T05:39:17.000Z","size":5981,"stargazers_count":335,"open_issues_count":182,"forks_count":150,"subscribers_count":25,"default_branch":"master","last_synced_at":"2024-07-22T05:32:55.282Z","etag":null,"topics":["ansible","azure","cloud","cluster","clustering","ec2","gcp","gridengine","hadoop","hpc","python","slurm","spark"],"latest_commit_sha":null,"homepage":"http://elasticluster.readthedocs.io/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elasticluster.png","metadata":{"files":{"readme":"README.rst","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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-03-20T10:13:21.000Z","updated_at":"2024-08-01T16:32:27.174Z","dependencies_parsed_at":"2024-08-01T16:32:18.993Z","dependency_job_id":"ac11a418-2787-4741-bbed-2bea1a21535c","html_url":"https://github.com/elasticluster/elasticluster","commit_stats":{"total_commits":2073,"total_committers":58,"mean_commits":"35.741379310344826","dds":"0.41775205016883743","last_synced_commit":"e435d5afa8a437b33ec29ba3ae6f7a6bfbb1e85d"},"previous_names":[],"tags_count":43,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elasticluster%2Felasticluster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elasticluster%2Felasticluster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elasticluster%2Felasticluster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elasticluster%2Felasticluster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elasticluster","download_url":"https://codeload.github.com/elasticluster/elasticluster/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223285170,"owners_count":17119852,"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":["ansible","azure","cloud","cluster","clustering","ec2","gcp","gridengine","hadoop","hpc","python","slurm","spark"],"created_at":"2024-08-01T15:05:23.804Z","updated_at":"2024-11-06T04:31:15.810Z","avatar_url":"https://github.com/elasticluster.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"========================================================================\n    ElastiCluster |travis-ci-status| |gitter|\n========================================================================\n\n.. This file follows reStructuredText markup syntax; see\n   http://docutils.sf.net/rst.html for more information\n\n.. |travis-ci-status| image:: https://travis-ci.org/gc3-uzh-ch/elasticluster.svg?branch=master\n\n.. |gitter| image:: https://badges.gitter.im/elasticluster/chat.svg\n   :alt: Join the chat at https://gitter.im/elasticluster/chat\n   :target: https://gitter.im/elasticluster/chat?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge\n\nElastiCluster_ aims to provide a user-friendly command line tool to\ncreate, manage and setup computing clusters hosted on cloud\ninfrastructures (like `Amazon's Elastic Compute Cloud EC2`_, `Google\nCompute Engine`_, or a private OpenStack_ cloud). Its main goal is\nto get your own private cluster up and running with just a few\ncommands; this video_ demoes ElastiCluster setting up a\ncomputational batch-queueing cluster.\n\nComplete documentation for ElastiCluster is available on the `Read The\nDocs \u003chttp://elasticluster.readthedocs.org/\u003e`_ website.  General\ndiscussion over ElastiCluster's usage, features, and bugs takes place\non the `elasticluster@googlegroups.com\n\u003chttps://groups.google.com/forum/#!forum/elasticluster\u003e`_ mailing-list\n(only subscribers can post).\n\nThe ElastiCluster_ project was initially an effort of the `Services and Support\nfor Science IT`_ (S3IT) unit at the `University of Zurich`_, licensed\nunder the `GNU General Public License version 3`_.  *Since 2020 it is no longer\nmaintained nor supported by S3IT or the University of Zurich.*\n\n\nFeatures\n========\n\nElastiCluster_ is in active development, and offers the following\nfeatures at the moment:\n\n* INI-style configuration file to define cluster templates\n* Can start and manage multiple independent clusters at the same time\n* Automated setup of:\n * HPC clusters using SLURM_ or GridEngine_ (incl. support for CUDA-enabled GPUs);\n * Spark_ / Hadoop_ clusters with HDFS and Hive/SQL;\n * distributed storage clusters using GlusterFS_, OrangeFS_, or Ceph_;\n * ...or anything that you can install with an Ansible_ playbook!\n* Growing and shrinking a running cluster.\n\nElastiCluster_ is currently in active development: please use the\nGitHub issue tracker to file `enhancement requests and ideas`_,\nor the `mailing-list`_ for discussion.\n\nWe appreciate pull requests for new features and enhancements. Please\nuse the *master* branch as starting point.\n\n\nQuickstart\n==========\n\nThe simplest way to run ElastiCluster is to use the official Docker\nimage.  If you cannot or want not to use Docker, please see alternate\ninstallation instructions on `ElastiCluster's Read The Docs\n\u003chttp://elasticluster.readthedocs.io/en/latest/install.html\u003e`_ website.\n\nTo install ElastiCluster over Docker: (1) download the `elasticluster.sh`_ script\nscript into a file `elasticluster.sh`, then (2) type this at your terminal\nprompt::\n\n    chmod +x elasticluster.sh\n\nThat's it!  You can now check that ElastiCluster is ready by running::\n\n    elasticluster.sh --help\n\nThe first time it is run, the `elasticluster.sh`_ script will check if\nDocker is installed, and ask for permission to install it if Docker is\nnot found. Follow the on-screen instructions; see section `Getting\nHelp`_ if you're in trouble.\n\nYou can also rename file ``elasticluster.sh`` to ``elasticluster``, if\nyou so like, to be consistent with the rest of the documentation.\n\n.. _`elasticluster.sh`: https://raw.githubusercontent.com/gc3-uzh-ch/elasticluster/master/elasticluster.sh\n\nAlternatively, you can also perform both steps at the terminal prompt::\n\n    # use this if the `wget` command is installed\n    wget -O elasticluster.sh https://raw.githubusercontent.com/gc3-uzh-ch/elasticluster/master/elasticluster.sh\n    chmod +x elasticluster.sh\n\n    # use this if the `curl` command is installed instead\n    curl -O https://raw.githubusercontent.com/gc3-uzh-ch/elasticluster/master/elasticluster.sh\n    chmod +x elasticluster.sh\n\nChoose either one of the two methods above, depending on whether\n``wget`` or ``curl`` is installed on your system (Linux systems\nnormally have ``wget``; MacOSX normally uses ``curl``).\n\nAfter ElastiCluster is installed, run this command to deploy an `example\nconfiguration file`_::\n\n  elasticluster list-templates\n\nThe configuration file is located in `.elasticluster/config`; adjust it\nto your liking using the `configuration reference`__.\n\n.. __: http://elasticluster.readthedocs.io/en/master/configure.html\n\nMore example configurations for popular cluster types can be found in\nthe `examples/`__ directory.\n\n.. __: https://github.com/elasticluster/elasticluster/tree/master/examples\n\n\nGetting help\n============\n\nFor anything concerning ElastiCluster, including trouble running the\ninstallation script, please send an email to\n`elasticluster@googlegroups.com\n\u003cmailto:elasticluster@googlegroups.com\u003e`_ or post a message on the web\nforum `\u003chttps://groups.google.com/forum/#!forum/elasticluster\u003e`_.\nInclude the full output of the script in your email, in order to help\nus to identify the problem.\n\n\n.. References\n\n   References should be sorted by link name (case-insensitively), to\n   make it easy to spot a missing or duplicate reference.\n\n.. _`Amazon's Elastic Compute Cloud EC2`: http://aws.amazon.com/ec2/\n.. _`Ansible`: https://ansible.com/\n.. _`CentOS`: http://www.centos.org/\n.. _`Ceph`: http://ceph.com/\n.. _`Debian GNU/Linux`: http://www.debian.org\n.. _`elasticluster`: http://gc3-uzh-ch.github.io/elasticluster/\n.. _`example configuration file`: https://github.com/elasticluster/elasticluster/blob/master/elasticluster/share/etc/config.template\n.. _`enhancement requests and ideas`: https://github.com/elasticluster/elasticluster/issues\n.. _`Ganglia`: http://ganglia.info\n.. _`GC3 Hobbes cloud`: http://www.gc3.uzh.ch/infrastructure/hobbes\n.. _`github elasticluster repository`: https://github.com/elasticluster/elasticluster\n.. _`github`: https://github.com/\n.. _`GlusterFS`: http://www.gluster.org/\n.. _`GNU General Public License version 3`: http://www.gnu.org/licenses/gpl.html\n.. _`Google Compute Engine`: https://cloud.google.com/products/compute-engine\n.. _`Grid Computing Competence Center`: http://www.gc3.uzh.ch/\n.. _`GridEngine`: http://gridengine.info\n.. _`Hadoop`: http://hadoop.apache.org/\n.. _`IPython cluster`: http://ipython.org/ipython-doc/dev/parallel/\n.. _`mailing-list`: https://groups.google.com/forum/#!forum/elasticluster\n.. _`OpenStack`: http://www.openstack.org/\n.. _`OrangeFS`: http://orangefs.org/\n.. _`pip`: https://pypi.python.org/pypi/pip\n.. _`python virtualenv`: https://pypi.python.org/pypi/virtualenv\n.. _`Python`: http://www.python.org\n.. _`Services and Support for Science IT`: http://www.s3it.uzh.ch/\n.. _`Spark`: http://spark.apache.org/\n.. _`SLURM`: https://slurm.schedmd.com/\n.. _`TORQUE+MAUI`: http://www.adaptivecomputing.com/products/open-source/torque/\n.. _`Ubuntu`: http://www.ubuntu.com\n.. _`University of Zurich`: http://www.uzh.ch\n.. _`video`: http://youtu.be/cR3C7XCSMmA\n\n.. (for Emacs only)\n..\n  Local variables:\n  mode: rst\n  End:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felasticluster%2Felasticluster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felasticluster%2Felasticluster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felasticluster%2Felasticluster/lists"}