orangecloudfoundry/squid repository overview

⁠Docker Proxy Squid

⁠What about squid

squid is a caching proxy for the Web, supporting HTTP and HTTPS.

This docker image supports a container with following features:

• Reduces bandwidth and improves response times by caching and reusing frequently-requested web pages
• Allow Internet access only for internal networks on port 80 and 443
• Squid transactions and cache logs are redirected to stdout

⁠How to get it ?

Pull the image from docker Hub:

docker pull orangecloudfoundry/squid

⁠How to build it ?

Clone Github repository:

git clone https://github.com/orange-cloudfoundry/squid.git

Then, build the image:

docker build -t squid .

Note: If you need to use proxy for Internet access (e.g: export http://IP_proxy:3128), you have to use the following syntax:

export http_proxy="http://`IP_proxy`:3128"
export https_proxy="http://`IP_proxy`:3128"
docker build --build-arg http_proxy=${http_proxy} --build-arg https_proxy=${https_proxy} -t squid .

⁠How to use it ?

⁠Use it as standalone container (on single docker host)

Launch the image:

docker run -p 3128:3128 -d --name squid -d orangecloudfoundry/squid

Acces to the container:

docker exec -it squid sh

⁠Use it with "Docker Bosh Release"

Another option is to deploy the container threw the Docker Bosh Release⁠.

In the following example:

• 1 instance of the container is deployed
• syslog driver catch squid logs from stdout
• Volume /var/spool/squid is mounted in the container (for cache directory)

Example of bosh deployment manifest:

instance_groups:
- name: internet-relay
  instances: 1
  vm_type: small
  stemcell: trusty
...

jobs:
  - {release: docker, name: docker}
  - {release: docker, name: containers}

  properties:
    containers:
    - name: internetsquid
      image: "orangecloudfoundry/squid"
      log_driver: syslog
      bind_ports:
      - "3128:3128"
      bind_volumes:
      - "/var/spool/squid"