Docker ile görseller için ölçeklendirme, sıkıştırma ve kırpma servisi #3N

Nedir bu?

docker-nginx-image-proxy görsel adresleri üzerinden görseller üzerinde anlık değişiklik yapabilmeyi sağlıyor. Docker ile kurulumu oldukça kolay ve sunduğu servis ile kullanımı gayet kolay.

Nasıl kurulur?

Docker kurulu bir web sunucunuz varsa kurulumunu github reposunu klonlayarak ya da direkt docker imajını çalıştararak yapabilirsiniz.

repoyu klonlamak için;

git clone https://github.com/niiknow/docker-nginx-image-proxy.git
cd docker-nginx-image-proxy
docker build -t nginx-image-proxy .

imajı çalıştırmak için;

docker run -d --restart=always -p 80:80 niiknow/nginx-image-proxy

-p ile servisi hangi portta kullanmak istiyorsanız onu belirtebilirsiniz. 5000:80 şeklinde belirtmeniz durumunda servisi ip:5000 şeklinde kullanabilirsiniz. Bir domain üzerinden kullanmak istiyorsanız reverse proxy ile apache ya da nginx için kurulumu yapabilirsiniz.

Nasıl kullanılır?

Kurulumu tamamladıktan sonra ip:5000 ya da bir domain üzerinden kurduysanız image.site.com gibi bir adresten aşağıdaki şekilde çağırarak kullanabilirsiniz.

image.site.com/rx/url-options/IMAGE_URL

IMAGE_URL kısmına değişiklik yapmak istediğiniz görsel adresi gelecek,
url-options kısmına ise görselle ilgili yapılması istenilen değişiklik parametleri gelecek.

Parametreler şunlar github adresinden kontrol edebilirsiniz;

code: name - valid values - default
  q: quality - 1..100 - 96 (default to best in case it's previously optimized) 
  w: width - uint - null
  h: height - uint - null
  c: crop - null, 1 - null
  rz: resize - null, 1 - 1
  g: gravity - NorthWest, North, NorthEast, West, Center, East, SouthWest, South, SouthEast *case-sensitive* - NorthWest
  e: sharpen - 1..100 - 0
  r: rotate - 0, 90, 180, 270 - 0
  ofmt: bmp, jpg, jpeg, png, gif, webp - force output format/span>e

Parametreleri url-options yazan kısma yazacaksanız w_100,h_100 şeklinde yazmanız gerekli. Parametreleri ayırırken virgül kullanabilirsiniz.

/w_100,h_100/

Alternatif seçenek olarak url-options kısmı olmadan querystring olarak ?w=100&h=100 şeklinde belirtebilirsiniz.

?w=100&h=100

kırpma seçeneği default olarak kapalı oluyor kırpma kullanılan bir örneği aşağıdaki adreste görebilirsiniz.

orjinal görsel;

servis ile kırpılan hali;

Servis görseli default olarak sol üstü merkez alarak kırpar. Ortalayarak bir kırpma yapılmasını istiyorsanız g parametresini Center olarak belirtmelisiniz.

Örnek;