{"id":28740997,"url":"https://github.com/aliyuncontainerservice/docker-machine-driver-aliyunecs","last_synced_at":"2026-01-12T06:10:56.116Z","repository":{"id":47167892,"uuid":"52201873","full_name":"AliyunContainerService/docker-machine-driver-aliyunecs","owner":"AliyunContainerService","description":"Aliyun (Alibaba Cloud) ECS Driver of Docker Machine","archived":false,"fork":false,"pushed_at":"2021-09-10T08:43:42.000Z","size":10452,"stargazers_count":204,"open_issues_count":3,"forks_count":51,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-30T12:34:37.576Z","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AliyunContainerService.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-02-21T10:43:35.000Z","updated_at":"2025-02-24T01:02:29.000Z","dependencies_parsed_at":"2022-09-26T18:21:54.131Z","dependency_job_id":null,"html_url":"https://github.com/AliyunContainerService/docker-machine-driver-aliyunecs","commit_stats":null,"previous_names":["denverdino/docker-machine-driver-aliyunecs"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AliyunContainerService/docker-machine-driver-aliyunecs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AliyunContainerService%2Fdocker-machine-driver-aliyunecs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AliyunContainerService%2Fdocker-machine-driver-aliyunecs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AliyunContainerService%2Fdocker-machine-driver-aliyunecs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AliyunContainerService%2Fdocker-machine-driver-aliyunecs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AliyunContainerService","download_url":"https://codeload.github.com/AliyunContainerService/docker-machine-driver-aliyunecs/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AliyunContainerService%2Fdocker-machine-driver-aliyunecs/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260116644,"owners_count":22961065,"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":"2025-06-16T07:09:49.079Z","updated_at":"2025-10-28T08:18:12.617Z","avatar_url":"https://github.com/AliyunContainerService.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--[metadata]\u003e\n+++\ntitle = \"Aliyun Elastic Compute Service\"\ndescription = \"Aliyun driver for machine\"\nkeywords = [\"machine, aliyun, driver, ecs\"]\n[menu.main]\nparent=\"smn_machine_drivers\"\n+++\n\u003c![end-metadata]--\u003e\n# Docker Machine Driver of Aliyun ECS\n\n[![Build Status](https://travis-ci.org/AliyunContainerService/docker-machine-driver-aliyunecs.svg?branch=master)](https://travis-ci.org/AliyunContainerService/docker-machine-driver-aliyunecs)\n\nCreate machines on [Aliyun Elastic Compute Service (ECS)](http://www.aliyun.com/).  You will need an Access Key ID, Secret Access Key and a Region ID.  If you want to setup instance on the VPC network, you will need the VPC ID and VSwitch ID; Please login to the Aliyun console -\u003e Products and Services -\u003e VPC and select the one where you would like to launch the instance.\n\ncreates docker instances on Aliyun ECS.\n\n```bash\ndocker-machine create -d aliyunecs machine-aliyunecs\n```\n\n## Installation\n\nThe easiest way to install the aliyun docker-machine driver is to:\n\n```\ngo get github.com/AliyunContainerService/docker-machine-driver-aliyunecs\n```\n\nbinaries also available,you can download from below links:\n\n* Mac OSX 64 bit: [docker-machine-driver-aliyunecs_darwin-amd64](https://docker-machine-aliyunecs-drivers.oss-cn-beijing.aliyuncs.com/docker-machine-driver-aliyunecs_darwin-amd64.tgz)\n\n* Linux 64 bit: [docker-machine-driver-aliyunecs_linux-amd64](https://docker-machine-aliyunecs-drivers.oss-cn-beijing.aliyuncs.com/docker-machine-driver-aliyunecs_linux-amd64.tgz)\n\n* Windows 64 bit: [docker-machine-driver-aliyunecs_windows-amd64](https://docker-machine-aliyunecs-drivers.oss-cn-beijing.aliyuncs.com/docker-machine-driver-aliyunecs_windows-amd64.tgz)\n\nHow to install docker-machine-driver-aliyunecs binary packages on different platforms.\n\n* Download the binary package for the corresponding platform. We currently support Windows, Linux, and MAC platforms\n* Extract the donload package\n\n  eg. Take the Mac platform for example\n  \n\t```\n\t\ttar zxvf docker-machine-driver-aliyunecs_darwin-amd64.tgz\n\t```\n\t\n* Rename the executable\n\n\t```\n\t#Windows\n\tdocker-machine-driver-aliyunecs.windows-amd64 =\u003e docker-machine-driver-aliyunecs.exe\n\t\n\t#Linux\n\tdocker-machine-driver-aliyunecs.linux-amd64 =\u003e docker-machine-driver-aliyunecs\n\t\n\t#Mac\n\tdocker-machine-driver-aliyunecs.darwin-amd64 =\u003e docker-machine-driver-aliyunecs\n\t```\n\n* Add docker-machine driver to the environment variables.\n\t\n\t```\n\texport PATH=\u003cYour Local Path\u003e/docker-machine-driver-aliyunecs[.exe]:$PATH\n\n\t```\n\n## Example Usage \neg. Export your credentials into your shell environment \n\n```bash\nexport ECS_ACCESS_KEY_ID='\u003cYour access key ID\u003e'\nexport ECS_ACCESS_KEY_SECRET='\u003cYour secret access key\u003e'\nexport ECS_REGION='\u003cYour region\u003e'\n\n# Using mirrors from Aliyun\nexport MACHINE_DOCKER_INSTALL_URL=http://kubernetes.oss-cn-hangzhou.aliyuncs.com/docker_install.sh\nexport ENGINE_REGISTRY_MIRROR=https://registry.docker-cn.com\n\ndocker-machine create -d aliyunecs \u003cmachine-name\u003e\n```\n\nor  pass as cmdline flags\n\n```bash\ndocker-machine create -d aliyunecs --aliyunecs-access-key-id=\u003cYour access key ID for the Aliyun ECS API\u003e --aliyunecs-access-key-secret=\u003cYour secret access key for the Aliyun ECS API\u003e  --aliyunecs-region=\u003cRegion\u003e \u003cmachine-name\u003e\n```\n\n## Examples\n\n#### using SSH key pair\n\n```\ndocker-machine create -d aliyunecs --aliyunecs-ssh-keypair test_keypair --aliyunecs-ssh-keypath ~/.ssh/id_rsa test\n```\n\n#### custom docker engine config\n\n```\ndocker-machine create -d aliyunecs --engine-storage-driver overlay2 test\n```\n\n#### custom OS config\n\n```\ndocker-machine create -d aliyunecs --aliyunecs-image-id centos_7_04_64_20G_alibase_201701015.vhd test\n```\n\n\n#### attach data disk for Docker containers\n\n```\ndocker-machine create -d aliyunecs --engine-storage-driver overlay2 --aliyunecs-disk-size 40 --aliyunecs-disk-fs xfs test\n```\n\n\n\n## Options\n\n```bash\ndocker-machine create -d aliyunecs --help\n```\n Option Name                                          | Description                                           | required \n------------------------------------------------------|------------------------------------------------------|----|\n``--aliyunecs-access-key-id`` | Your access key ID for the Aliyun ECS API.  |**yes**|\n``--aliyunecs-access-key-secret``|Your secret access key for the Aliyun ECS API.| **yes** |\n``--aliyunecs-api-endpoint``|The custom API endpoint.| |\n``--aliyunecs-description`` | The description of instance.| |\n``--aliyunecs-disk-size``| The data disk size for /var/lib/docker (in GB)||\n``--aliyunecs-disk-fs``|The file system for data disk (ext4 or xfs).||\n``--aliyunecs-disk-category``|The category of data disk, the valid values could be `cloud` (default), `cloud_efficiency` or `cloud_ssd`.||\n``--aliyunecs-system-disk-size``| The system disk size for /var/lib/docker (in GB)||\n``--aliyunecs-system-disk-category``|The category of system disk, the valid values could be `cloud` (default), `cloud_efficiency` or `cloud_ssd`.||\n``--aliyunecs-image-id``| The image ID of the instance to use Default is the latest Ubuntu 16.04 provided by system||\n``--aliyunecs-io-optimized``| The I/O optimized instance type, the valid values could be `none` (default) or `optimized`||\n``--aliyunecs-instance-type``| The instance type to run.  Default: `ecs.n4.small`||\n``--aliyunecs-internet-max-bandwidth``| Maximum bandwidth for Internet access (in Mbps), default 1||\n``--aliyunecs-internet-charge-type``| [Internet charge type](https://www.alibabacloud.com/help/doc-detail/25411.htm), the valid values could be `PayByTraffic` (default) or `PayByBandwidth`||\n``--aliyunecs-private-address-only``| Use the private IP address only||\n``--aliyunecs-region``| The region to use when launching the instance. Default: `cn-hangzhou`||\n``--aliyunecs-route-cidr``| The CIDR to use configure the route entry for the instance in VPC. Sample: 192.168.200.0/24||\n``--aliyunecs-security-group``| Aliyun security group name. Default: `docker-machine`||\n``--aliyunecs-slb-id``|SLB id for instance association||\n``--aliyunecs-ssh-password``| SSH password for created virtual machine. Default is random generated.||\n``--aliyunecs-ssh-keypair``| SSH key pair name ||\n``--aliyunecs-ssh-keypath``| File path of SSH private key ||\n``--aliyunecs-tag``| Tag for the instance.||\n``--aliyunecs-vpc-id``| Your VPC ID to launch the instance in. (required for VPC network only)||\n``--aliyunecs-vswitch-id``| Your VSwitch ID to launch the instance with. (required for VPC network only)||\n``--aliyunecs-zone``| The availability zone to launch the instance||\n\n## Environment variables and default values:\n\n| CLI option                          | Environment variable        | Default          |\n|-------------------------------------|-----------------------------|------------------|\n| **`--aliyunecs-access-key-id`**     | `ECS_ACCESS_KEY_ID`         | -                |\n| **`--aliyunecs-access-key-key`**    | `ECS_ACCESS_KEY_SECRET`     | -                |\n| `--aliyunecs-api-endpoint`          | `ECS_API_ENDPOINT`          | -                |\n| `--aliyunecs-description`           | `ECS_DESCRIPTION`           | -                |\n| `--aliyunecs-disk-size`             | `ECS_DISK_SIZE`             | -                |\n| `--aliyunecs-disk-category`         | `ECS_DISK_CATEGORY`         | -                |\n| `--aliyunecs-disk-fs`               | `ECS_DISK_FS`               | `ext4`           |\n| `--aliyunecs-system-disk-size`      | `ECS_SYSTEM_DISK_SIZE`      | -                |\n| `--aliyunecs-system-disk-category`  | `ECS_SYSTEM_DISK_CATEGORY`  | -                |\n| `--aliyunecs-image-id`              | `ECS_IMAGE_ID`              | -                |\n| `--aliyunecs-aliyunecs-io-optimized`| `ECS_IO_OPTIMIZED`          | `none`           |\n| `--aliyunecs-instance-type`         | `ECS_INSTANCE_TYPE`         | `ecs.t1.small`   |\n| `--aliyunecs-internet-max-bandwidth`| `ECS_INTERNET_MAX_BANDWIDTH`| `1`              |\n| `--aliyunecs-internet-charge-type`  | `ECS_INTERNET_CHARGE_TYPE`  | `PayByTraffic`   |\n| `--aliyunecs-private-address-only`  | `ECS_PRIVATE_ADDR_ONLY`     | `false`          |\n| `--aliyunecs-region`                | `ECS_REGION`                | `cn-hangzhou`    |\n| `--aliyunecs-route-cidr`            | `ECS_ROUTE_CIDR`            | -                |\n| `--aliyunecs-security-group`        | `ECS_SECURITY_GROUP`        | -                |\n| `--aliyunecs-slb-id`                | `ECS_SLB_ID`                | -                |\n| `--aliyunecs-ssh-password`          | `ECS_SSH_PASSWORD`          | Random generated |\n| `--aliyunecs-ssh-keypair`           | `ECS_SSH_KEYPAIR`           | -                |\n| `--aliyunecs-ssh-keypath`           | `ECS_SSH_KEYPATH`           | -                |\n| `--aliyunecs-tag`                   | `ECS_TAGS`                  | -                |\n| `--aliyunecs-vpc-id`                | `ECS_VPC_ID`                | -                |\n| `--aliyunecs-vswitch-id`            | `ECS_VSWITCH_ID`            | -                |\n| `--aliyunecs-zone`                  | `ECS_ZONE`                  | -                |\n\nEach environment variable may be overloaded by its option equivalent at runtime.\n\n## OS\n\nThe default OS is Ubuntu 16.04, and you can select your preferred image-id\n\n## Hacking\n\n### Get the sources\n\n```bash\ngo get github.com/AliyunContainerService/docker-machine-driver-aliyunecs\ncd $GOPATH/src/github.com/AliyunContainerService/docker-machine-driver-aliyunecs\n```\n\n### Test the driver\n\nTo test the driver make sure your current build directory has the highest\npriority in your ``$PATH`` so that docker-machine can find it.\n\n```\nexport PATH=$GOPATH/src/github.com/AliyunContainerService/docker-machine-driver-aliyunecs:$PATH\n```\n\n## Related links\n\n- **Docker Machine**: https://docs.docker.com/machine/\n- **Contribute**: https://github.com/AliyunContainerService/docker-machine-driver-aliyunecs\n- **Report bugs**: https://github.com/AliyunContainerService/docker-machine-driver-aliyunecs/issues\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliyuncontainerservice%2Fdocker-machine-driver-aliyunecs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faliyuncontainerservice%2Fdocker-machine-driver-aliyunecs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliyuncontainerservice%2Fdocker-machine-driver-aliyunecs/lists"}