{"id":20790499,"url":"https://github.com/docker-production-aws/docker-squid","last_synced_at":"2025-05-05T20:45:07.861Z","repository":{"id":176607455,"uuid":"84354738","full_name":"docker-production-aws/docker-squid","owner":"docker-production-aws","description":"Docker Image for running Squid Proxy","archived":false,"fork":false,"pushed_at":"2018-01-15T14:01:47.000Z","size":11,"stargazers_count":11,"open_issues_count":0,"forks_count":44,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-30T23:31:36.661Z","etag":null,"topics":["alpine","alpine-linux","aws","docker","docker-image","pluralsight","squid","squid-proxy"],"latest_commit_sha":null,"homepage":null,"language":"Makefile","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/docker-production-aws.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-03-08T18:47:22.000Z","updated_at":"2024-05-11T14:55:27.000Z","dependencies_parsed_at":"2024-02-06T01:33:16.050Z","dependency_job_id":null,"html_url":"https://github.com/docker-production-aws/docker-squid","commit_stats":null,"previous_names":["docker-production-aws/docker-squid"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker-production-aws%2Fdocker-squid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker-production-aws%2Fdocker-squid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker-production-aws%2Fdocker-squid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/docker-production-aws%2Fdocker-squid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/docker-production-aws","download_url":"https://codeload.github.com/docker-production-aws/docker-squid/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252574234,"owners_count":21770357,"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":["alpine","alpine-linux","aws","docker","docker-image","pluralsight","squid","squid-proxy"],"created_at":"2024-11-17T15:35:27.756Z","updated_at":"2025-05-05T20:45:07.855Z","avatar_url":"https://github.com/docker-production-aws.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker in Production using AWS Proxy Docker Image\n\nThis repository defines a Docker Image for running [Squid](http://www.squid-cache.org) as a forward proxy in AWS environments.\n\n## Building the Image\n\nTo build this image the following prerequisites are required:\n\n- Docker Client with access to a Docker Engine (1.12 or higher)\n- Docker Compose 1.7 or higher\n- GNU Make 3.82 or higher\n- AWS CLI 1.10 or higher\n- AWS profile/environment configured with privileges to push images to the ECR repository\n\nTo build the image use the `make release` command:\n\n```\n$ make release\nBuilding squid\nStep 1 : FROM alpine\nlatest: Pulling from library/alpine\nDigest: sha256:1354db23ff5478120c980eca1611a51c9f2b88b61f24283ee8200bf9a54f2e5c\nStatus: Image is up to date for alpine:latest\n ---\u003e baa5d63471ea\nStep 2 : MAINTAINER Justin Menga \u003cjustin.menga@gmail.com\u003e\n ---\u003e Using cache\n ---\u003e f0ecea783770\n...\n...\nStep 11 : CMD squid -f /etc/squid/squid.conf -NYCd 1\n ---\u003e Using cache\n ---\u003e ad9b93514414\nSuccessfully built ad9b93514414\n=\u003e Build complete\n=\u003e Starting squid service...\nCreating network \"squid_default\" with the default driver\nCreating squid_squid_1\n=\u003e Release environment created\n=\u003e Squid is running at http://172.16.154.128:32779\n```\n\nAfter building the image, you can test the image locally by configuring your browser or environment to use the Squid proxy URL output displayed at the end of the `make release` command.\n\n### Tagging the Image\n\nAfter building the image, you can tag the image using the `make tag` or `make tag [\u003ctag\u003e...]` command:\n\n```\n$ make tag\n=\u003e Tagging release image with tags latest 20161211161608.52ce7ab 52ce7ab...\n=\u003e Tagging complete\n```\n\n### Publishing the Image\n\nWith the image tagged, you can login to the AWS EC2 Container Service Registry (ECR) and publish the image:\n\n```\n$ make login\n=\u003e Logging in to Docker registry ...\nEnter MFA code: xxxxxx\nLogin Succeeded\n=\u003e Logged in to Docker registry\n$ make publish\n=\u003e Publishing release image to 543279062384.dkr.ecr.us-west-2.amazonaws.com/dockerproductionaws/squid...\nThe push refers to a repository [543279062384.dkr.ecr.us-west-2.amazonaws.com/dockerproductionaws/squid]\neb40ed4586e2: Pushed\nd93c9b2eda1f: Pushed\n66fb5c668a31: Pushed\n02535d447192: Pushed\n011b303988d2: Pushed\n20161211161608.52ce7ab: digest: sha256:f347746ec71c7a1fc00f534af27392b0eec5b8d300c191bb87e74753f7b9bcd6 size: 7708\n...\n...\n=\u003e Publish complete\n```\n\n### Cleaning up\n\nTo clean up after building, tagging and publishing the image, use the `make clean` command:\n\n```\n$ make clean\n=\u003e Destroying release environment...\nStopping squid_squid_1 ... done\nRemoving squid_squid_1 ... done\nRemoving network squid_default\n=\u003e Removing dangling images...\nDeleted: sha256:ec70a518b87d42e63a9b05f3a4324a8a6e3d57e941ed106d43bea67a35ecca92\nDeleted: sha256:d65f4e883440a995add44493bdc1ae6d565bd06f9d5aca471afed1b4423cd2ec\nDeleted: sha256:ce7014ef547d1c5069148e33b57ce34c85308de37ef6d10408f842f152154145\nDeleted: sha256:b21f12ac9c4cd0aa1673d305186717035dbd2cd1e4efc8829c9f2107f76d306d\nDeleted: sha256:4e1dcefb3ef4387d035ac542694b39d51c499005240a343e7b5a4c586f85714b\nDeleted: sha256:c9698d6fd30176afdc71f95c78259c376801e07a7065b52f0739ea422d808bbe\nDeleted: sha256:8baa4adc1cff29eb794b28062ac0ea231503ed984f89d2a71af54b2ff11d1f98\nDeleted: sha256:5b6baf58e99ba6d79022d17a510d8e58b418c10bf2a09b429941a04792cec6b7\nDeleted: sha256:a4308d3bb2b335a505bbdb7b79fa5ddbe4e773919260a95dc8b497612d7df3ab\nDeleted: sha256:9d3e54d0d7900c6d93e7081613e5229f266d919dc105f8d848a57262f1058326\nDeleted: sha256:e800bfff628f614dabb01d7b6ea7438deb4242cf24909a554808499b2ee6870b\n=\u003e Clean complete\n```\n\n## Runtime Configuration\n\n### Squid Whitelist\n\nA default whitelist template is included with this image that permits access to AWS services.\n\nThe whitelist is generated by a whitelist template that is created on container startup based upon environment variables supplied to the container (see the Squid Configuration section below).\n\nThe following is the default whitelist that is generated if no configuration is provided to the container:\n\n```\n.us-west-2.amazonaws.com\n.s3-us-west-2.amazonaws.com\niam.amazonaws.com\nsts.amazonaws.com\nsupport.us-east-1.amazonaws.com\nwaf.amazonaws.com\ncloudfront.amazonaws.com\nroute53.amazonaws.com\nroute53domains.us-east-1.amazonaws.com\ndevicefarm.us-west-2.amazonaws.com\nimportexport.amazonaws.com\n```\n\n### Squid Configuration \n\nThe following table defines environment variables control the configuration of containers created from this image.\n\n| Environment Variable | Required | Default Value  | Description                                                                                                                                               | Examples                     |\n|----------------------|----------|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------|\n| SQUID_WHITELIST      | No       |                | Comma separated list of whitelisted domains.  Note that this whitelist adds the default whitelist that permits access to AWS services.                    | .dockerproductionaws.org,.google.com |\n| AWS_REGIONS          | No       | us-west-2      | Comma separate list of regions that the whitelist should perform for access to AWS services.  This only affects AWS services that are regional in nature. | ap-southeast-2,us-west-2             |\n| ALLOWED_CIDRS        | No       | RFC1918 ranges | Comma separated list of allowed CIDR ranges permitted to use the Proxy.  This typically should be set to the CIDR block range of your VPC.                | 192.168.200.0/20                     |","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocker-production-aws%2Fdocker-squid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdocker-production-aws%2Fdocker-squid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdocker-production-aws%2Fdocker-squid/lists"}