[{"_1":2,"_155":-5,"_156":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_134":135},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_125":-5,"_126":11,"_127":17,"_128":11,"_129":-5,"_130":11,"_131":-5,"_132":133},"canonicalUrl","https://hub.docker.com/r/psywolf/lucy/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","psywolf","reponame","lucy","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":17,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2017-05-04T09:37:03.029085Z","description","Lucy for Jmeter","is_private","last_updated","2018-08-20T14:21:48.411597Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",787,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# JMeter for ECS\nJMeter Images for Distributed Testing on EC2 Container Service (ECS)\n\nThis application uses two images:\n* `smithmicro/jmeter` - Contains the JMeter software that is deployed in ECS\n* `smithmicro/lucy` - The orcehstration image that can run behind a corporate firewall and manages AWS resources\n\n_Warning: Using these Docker images will incur compute and storage costs in AWS. Care is taken to terminate all instances and volumes after JMeter tests complete, but bugs could allow these resources to continue to run. See the issues list for more detail._\n\n## How to Use\nThe `smithmicro/lucy` Docker image can be run as-is with a number of required environement variables.\n\nPrerequisites to use this image:\n* Create a VPC with at least one subnet as ECS requires the use of VPC **\n* Create a VPC security group that allows ports 22, 1099, 50000 and 51000 (tcp) to the VPC **\n* Create a security key pair and place in the `keys` subdirectory\n* Have your AWS CLI Access Key ID/Secret Access Key handy\n* Replace or edit the included `plans/demo.jmx` to run your specific tests\n* Ensure you have a Role named `ecsInstanceRole`. This is created by the ECS first-run experience.\n * More details here: http://docs.aws.amazon.com/AmazonECS/latest/developerguide/instance_IAM_role.html\n\n** If you do not have a VPC created, you can use the included `aws-setup.sh` script to create the VPC, Subnet and required Security Group.\n\nDocker run template:\n```\ndocker run -v :/plans -v :/keys -v :/logs \\\n --env AWS_ACCESS_KEY_ID= \\\n --env AWS_SECRET_ACCESS_KEY= \\\n --env AWS_DEFAULT_REGION= \\\n --env SECURITY_GROUP= \\\n --env SUBNET_ID= \\\n --env KEY_NAME= \\\n --env MINION_COUNT= \\\n --enc INSTANCE_TYPE= \\\n smithmicro/lucy /plans/demo.jmx\n```\nFor 5 test instances in N. Virginia, `docker run` would look like this, assuming your `jmeter-key.pem` file is located in the `keys` subdirectory:\n```\ndocker run -v $PWD/plans:/plans -v $PWD/keys:/keys -v $PWD/logs:/logs \\\n --env AWS_ACCESS_KEY_ID=ABCDEFGHIJKLMNOPQRST \\\n --env AWS_SECRET_ACCESS_KEY=abcdefghijklmnopqrstuvwxyz0123456789ABCDEF \\\n --env AWS_DEFAULT_REGION=us-east-1 \\\n --env SECURITY_GROUP=sg-12345678 \\\n --env SUBNET_ID=subnet-12345678 \\\n --env KEY_NAME=jmeter-key \\\n --env MINION_COUNT=5 \\\n --enc INSTANCE_TYPE=t2.small \\\n smithmicro/lucy /plans/demo.jmx\n```\n\n## Architecture\nThis Docker image replaces the JMeter master/slave nomenclature with *Gru*, *Minion* and *Lucy*. *Gru* manages the *Minions* from within EC2, but *Lucy* orchestrates the entire process.\n\n```\n+-------------------------------------+\n| EC2 +-----------------+ |\n| | ECS | |\n| | +--------+ | |\n| +---------+ | | +--------+ | | +--------+\n| | |---->| | +--------+ ---------->| |\n| | Gru |<----| | | | ---------->| Target |\n| | | | +-| | Minion | ---------->| |\n| +---------+ | +-| | | | +--------+\n| ^ | | +--------+ | |\n| | | +-----------------+ |\n+------|-|----------------------------+\n | |\n .jmx | | .log/.jtl\n | v\n +----------+\n | |\n | Lucy |\n | |\n +----------+\n```\n\n*Lucy* runs the `lucy.sh` script to perform the following steps:\n* Step 1 - Create an ECS Cluster\n* Step 2 - Create all instances and register them with the Cluster\n* Step 3 - Create the Minion ECS task\n* Step 4 - Wait until the instances are running and registered with the Cluster\n* Step 5 - Fetch our Contatiner Instance IDs\n* Step 6 - Run a Minion Task with the requested instance count\n* Step 7 - Get public IP addresses from Gru and Minions\n* Step 8 - Run Gru with the specified JMX\n * JMeter does its thing here\n * Once complete, copy the jmeter.log and results.jtl files from Gru to Lucy\n* Step 9 - Stop all Tasks\n* Step 10 - Terminate all instances\n* Step 11 - Delete the cluster\n\n### Volumes\nThe `lucy` container uses 3 volumes:\n* `/plans` - mapped into the orchestrator to provide the input JMX files\n* `/keys` - mapped into the orchestrator to provide the PEM file\n* `/logs` - mapped into the orchestrator to provide the output jmeter.log and results.jtl\n\n## Local Testing with Docker Compose\nThe `jmeter/docker-compose.yml` file allows for local testing of the Gru and Minion nodes without incurring costs from AWS.\nEdit the docker-compose.yml file and replicate the `links`, `environment` and `minionN` sections to increase the number of Minions to test.\n```\nversion: '2'\n\nservices:\n gru:\n ...\n links: \n - minion1\n - minion2\n - minion3\n - minion4\n environment: \n - MINION_HOSTS=minion1,minion2,minion3,minion4\n ...\n minion1:\n image: smithmicro/jmeter:latest\n minion2:\n image: smithmicro/jmeter:latest\n minion3:\n image: smithmicro/jmeter:latest\n minion4:\n image: smithmicro/jmeter:latest\n\n```\nThen run:\n```\ndocker-compose up\n```\nUsing the `docker-compose scale` command does not work as it creates hostnames like `minion_1`. This causes an error in JMeter as it uses the hostname in URL form and sees the underscore as an illegal URL character.\n\n## Notes\nThis Docker image uses the Instance Metadata API documented here:\n* http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html\n\nTo get the instance public hostname within the `entrypoint.sh` script, we call:\n* `curl -s --max-time 5 http://169.254.169.254/latest/meta-data/public-hostname`\n\nFor more information on JMeter Distributed Testing, see:\n* http://jmeter.apache.org/usermanual/remote-test.html\n\n## Inspired by...\nhttps://en.wikipedia.org/wiki/Despicable_Me_2\n\n![Minions](https://pbs.twimg.com/tweet_video_thumb/C8CtmUbVwAAaboL.jpg \"Minions\")","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",155845903,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",788853,"full_size",39803067,"id",10583632,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:32abdae0616f52b71bfcdc6561a508d62bbc0708e44e866587ff84a268ada0ba","features","","last_pulled","2026-09-22T00:04:39.359734688Z","last_pushed","2018-08-20T13:27:56Z","os","linux","os_features","os_version","size","variant","2018-08-20T14:21:47.995237Z","last_updater","last_updater_username","media_type","latest","repository",1460683,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":136,"_143":144,"_132":153,"_154":11},{"_36":137,"_38":138,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":139,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":140,"_75":17,"_76":142,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":141},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_145":60,"_146":-5,"_147":-5,"_148":149},"count","next","previous","results",[150],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":151,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[152],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

psywolf/lucy

Tags for psywolf/lucy