86 lines
2 KiB
Markdown
86 lines
2 KiB
Markdown
# memcached
|
|
|
|
Memcached is High Performance, Distributed Memory Object Cache
|
|
|
|
## How to use the container
|
|
|
|
Pull the image from Docker Hub:
|
|
|
|
```bash
|
|
$ sudo docker pull registry.fedoraproject.org/memcached:rawhide
|
|
```
|
|
|
|
Run the container
|
|
|
|
```bash
|
|
docker run -it -p 11211:11211 --name memcached modularitycontainers/memcached
|
|
```
|
|
|
|
If you would like to debug memcached, use container option =e MEMCACHED_DEBUG_MODE:
|
|
```bash
|
|
docker run -it -p 11211:11211
|
|
[-e MEMCACHED_DEBUG_MODE]
|
|
--name memcached modularitycontainers/memcached
|
|
```
|
|
|
|
If you would like to change memcached options, like cache_size, connections or threads, use environment variable -e MEMCACHED_CACHE_SIZE, -e MEMCACHED_CONNECTIONS, -e MEMCACHED_THREADS respectively:
|
|
```bash
|
|
docker run -it -p 11211:11211
|
|
[-e MEMCACHED_CACHE_SIZE=<size_in_MB>]
|
|
[-e MEMCACHED_CONNECTIONS=<max_simultaneous_connections>]
|
|
[-e MEMCACHED_THREADS=<max_concurrent_threads>]
|
|
--name memcached modularitycontainers/memcached
|
|
```
|
|
|
|
## A demo
|
|
|
|
Here is a simple demo how to run memcached
|
|
|
|
* Copy systemd service which will take care of memcached container:
|
|
```bash
|
|
$ sudo cp -av memcached-container.service /usr/lib/systemd/system/
|
|
$ sudo systemctl daemon-reload
|
|
```
|
|
|
|
* We can start memcached now:
|
|
```bash
|
|
$ sudo systemctl start memcached-container
|
|
```
|
|
|
|
* You should be able to test memcached by commands (taken from http://www.journaldev.com/16/memcached-telnet-commands-with-example):
|
|
```bash
|
|
set Test 0 100 10
|
|
JournalDev
|
|
STORED
|
|
get Test
|
|
VALUE Test 0 10
|
|
JournalDev
|
|
END
|
|
replace Test 0 100 4
|
|
Temp
|
|
STORED
|
|
get Test
|
|
VALUE Test 0 4
|
|
Temp
|
|
END
|
|
stats items
|
|
STAT items:1:number 1
|
|
STAT items:1:age 19
|
|
STAT items:1:evicted 0
|
|
STAT items:1:evicted_time 0
|
|
STAT items:1:outofmemory 0
|
|
STAT items:1:tailrepairs 0
|
|
END
|
|
flush_all
|
|
OK
|
|
get Test
|
|
END
|
|
version
|
|
VERSION 1.4.25
|
|
quit
|
|
```
|
|
|
|
## Repository structure
|
|
|
|
- Dockerfile - build container image with memcached.
|
|
- openshift-template.yml - Template for OpenShift to memcached.
|