[{"_1":2,"_187":-5,"_188":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_162":163},"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":85,"_104":105,"_153":-5,"_154":11,"_155":17,"_156":11,"_157":-5,"_158":11,"_159":-5,"_160":161},"canonicalUrl","https://hub.docker.com/r/smartercleanup/nginx/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","smartercleanup","reponame","nginx","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":-5,"_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","2016-03-07T09:29:33.78023Z","description","smartercleanup webapp nginx server","is_private","last_updated","2016-03-15T08:32:54.738232Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.distribution.manifest.v1+prettyjws","name","pull_count",1704,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","Getting started with Lua web development using docker as your Lua web application server\n-----------------------------------------------\n\n\nIn this blog post I will guide you through a path to getting you started with Lua web development by using the container technology software [Docker][1].\n\nWhy [Docker][1] ?\n-----------------\n\nFrom their web page:\n> Docker is an open-source project to easily create lightweight, portable, self-sufficient containers from any application. The same container that a developer builds and tests on a laptop can run at scale, in production, on VMs, bare metal, OpenStack clusters, public clouds and more. \n\nThis means that we have an excellent way to reproduce and contain a development setup for the Lua project we will be creating that will not mess up your system the way most application package managers like npm, luarocks, virtualenv + easy_install/pip likes to do. Another major drawback with most application package managers are that they are not good at creating isolated enviroments, so you will have version conflicts or breakage if application1 wants a different version of a library than application2. Or like invirtualenv's case it will still be tied to the system in some ways.\n\nThe goal of this guide is to end up in this type of setup:\n\n Internets => nginx:80\n |--> docker (app1):8080 \n | |--> nginx+lua: 8080\n |--> docker (app2):8090\n | |--> nginx+lua: 8090\n ...\n\nThe point is that we use [Docker][1] the way we normally would use an app server like uwsgi, gunicorn, nodejs, php5-fpm or similar.\n\nWhy [Openresty][2] ?\n--------------------\n\nA downside with running Lua(jit) inside your Nginx is that this is not enabled by default in most distributions of Nginx, and since Nginx does not (yet) support dynamic loading of modules which means a recompile of Nginx is needed to get support for running Lua. And while Nginx recompilation is really fast, and it while it supports hot code reload, it is still painful because of security and maintainability considerations.\n\nTo get Lua support in Nginx we will be using the Nginx-bundle called [Openresty][2]. Openresty comes bundled with many Nginx and Lua modules useful for web development.\n\n### Building our Dockerfile\n\n\nA Dockerfile is:\n> Docker can act as a builder and read instructions from a text Dockerfile to automate the steps you would otherwise take manually to create an image. Executing docker build will run your steps and commit them along the way, giving you a final image\n\nWe will create a Dockerfile which sets up a Ubuntu with [Openresty][2].\n\nInstallation help for Ubuntu will be provided, if you use a different Linux distribution please find instructions here: \n\nInstallation of [Docker][1] on Ubuntu with kernel 3.8 or newer:\n\n sudo curl https://get.docker.io/gpg | sudo apt-key add -\n\n sudo sh -c \"echo deb http://get.docker.io/ubuntu docker main\\\n echo deb \"echo deb http://get.docker.io/ubuntu docker main\" | sudo tee /etc/apt/sources.d/docker.list\n sudo apt-get update\n sudo apt-get install lxc-docker\n \n### Create a project directory, with logdir, nginx.conf and Dockerfile\n\n mkdir helloproj\n mkdir helloproj/logs\n cd helloproj\n \n cat < Dockerfile\n # Dockerfile for openresty\n # VERSION 0.0.1\n\n FROM ubuntu:12.04\n MAINTAINER Tor Hveem \n ENV REFRESHED_AT 2013-12-12\n\n RUN echo \"deb-src http://archive.ubuntu.com/ubuntu precise main\" >> /etc/apt/sources.list\n RUN sed -i /etc/apt/sources.list 's/main$/main universe/'\n RUN apt-get update\n RUN apt-get -y upgrade\n RUN apt-get -y install wget vim git libpq-dev\n\n # Openresty (Nginx)\n RUN apt-get -y build-dep nginx\n RUN wget http://openresty.org/download/ngx_openresty-1.4.3.9.tar.gz\n RUN tar xvfz ngx_openresty-1.4.3.9.tar.gz\n RUN cd ngx_openresty-1.4.3.9 ; ./configure --with-luajit --with-http_addition_module --with-http_dav_module --with-http_geoip_module --with-http_gzip_static_module --with-http_image_filter_module --with-http_realip_module --with-http_stub_status_module --with-http_ssl_module --with-http_sub_module --with-http_xslt_module --with-ipv6 --with-http_postgres_module --with-pcre-jit; make ; make install\n\n EXPOSE 8080\n CMD /usr/local/openresty/nginx/sbin/nginx -p `pwd` -c nginx.conf\n\n EOF\n \n### Build the image using our Dockerfile\n \n sudo docker build -t=\"torhve/openresty\" .\nThis will create the contained environment which we then can re-use and launch for many projects later. The `-t` flag is the name for the image, you can choose your own name here if you want, to help you refer to the image by name later. The name mostly matters if you want to share/submit your docker image to repositories, see: for more information about that.\n\n\n### Create a simple nginx.conf for the project\n\n cat < nginx.conf\n worker_processes 1;\n error_log stderr notice;\n daemon off;\n events {\n worker_connections 1024;\n }\n\n http {\n variables_hash_max_size 1024;\n access_log off;\n include /usr/local/openresty/nginx/conf/mime.types;\n set_real_ip_from 127.0.0.1/8;\n real_ip_header X-Real-IP;\n charset utf-8;\n\n server {\n listen 8080;\n lua_code_cache off;\n\n location / {\n default_type text/html;\n content_by_lua_file \"app.lua\";\n }\n\n location /static/ {\n alias static/;\n }\n }\n }\n\n EOF\n \nNow we can start the docker image that we built. We will map the directory from the host to the container so you can continue to use your favorite editor and development environment from the host. Note that the nginx.conf and app lives outside the container, so you can re-use this container image for all of your lua projects.\n\n### Run our newly created Docker image\n\n sudo docker run -t -i -p 8080:8080 -v=`pwd`:/helloproj -w=/helloproj torhve/openresty \n`-p` expose the container port 8080 to the host port 8080.\n`-v` is the shared directory.\n`-w` is the working directoriy inside the container.\n`-t` and `-i` for interactive tty.\n`torhve/openresty` is the name of the image. List images with `sudo docker images`\n\n### Create the Hello World app.lua\n\n cat < app.lua\n ngx.say('Hello World!')\n ngx.exit(200)\n EOF\n\nThe nginx web server should now be serving content, lets confirm with `curl`:\n\n curl http://127.0.0.1:8080/\nWhich should print:\n \n Hello World!\n\n*Awesome!*\n\n### Deploy\n\n\nTo serve content to the internets let me show you to configure Nginx running on the host to get content from our helloproj Docker image. You could easily have two (or more!) running Docker process on different ports, one with `lua_code_cache on` on one port for production, and one without it for development. Here is a simplistic nginx conf that will proxy the connections to the Docker image:\n\n cat < /etc/nginx/sites-enabled/helloproj.conf\n server {\n listen 80;\n \n location / {\n proxy_pass http://127.0.0.1:8080/;\n proxy_set_header X-Real-IP $remote_addr;\n }\n }\n EOF\n \nBasically we just proxy every request to the container using the built in proxy feature of Nginx. We also use set the real IP header to the clients IP address so the contained Nginx process can see the client's IP address. \n\nTo extend/improve this setup you could set the root directory to be the same directory as the helloproj and then serve static content using the host nginx, and let the contained nginx only worry about dynamic content. It could also be extended to cache requests using one of the many Nginx caching techniques.\n\nTo start and keep your containers running you can use many different techniques, some viable solutions are systemd, supervisord, upstart, or just a good old initscript.\n\n### Potential pitfalls\n\nRunning two Nginxes will have an impact on performance compared to running a single app on a single front facing Nginx, because every request will be proxied. This is similar to what many app servers will also have to do in some ways, but usually one of the advantages of Lua (and php!) is that you can run your application directly inside the webserver without any proxying. So for instance if you have an application that handles large uploads you need to think about how you want to handle that. \n\n\nThe source for this guide is available in a [GitHub repository][3]. Please fork and send changes if you have suggestions or improvements.\n\n\n [1]: http://docker.io/ \"Docker\"\n [2]: http://openresty.org/\n [3]: https://github.com/torhve/openresty-docker\n","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",390066302,"orgData",{"_86":87,"_88":89,"_90":91,"_92":29,"_93":94,"_95":94,"_96":94,"_97":94,"_98":99,"_100":94,"_101":94,"_102":94,"_103":17},"id","7fdb9176c53d472b80ea313995baf1d0","uuid","7fdb9176-c53d-472b-80ea-313995baf1d0","type","organization","orgname","full_name","","location","company","profile_url","date_joined","2015-07-14T05:05:50.871896Z","gravatar_url","gravatar_email","badge","is_active","recentTags",[106,142],{"_107":40,"_108":109,"_110":111,"_86":112,"_113":114,"_46":131,"_132":109,"_133":29,"_134":52,"_53":135,"_136":137,"_138":122,"_139":131,"_140":62,"_141":17},"content_type","creator",369421,"full_size",218078765,2218481,"images",[115],{"_116":117,"_118":119,"_120":94,"_121":122,"_123":124,"_125":94,"_126":94,"_127":-5,"_128":129,"_59":62,"_130":-5},"architecture","amd64","digest","sha256:08a524c0f5d22716d3627f33c4c96fe058a9ef9b963ebc57573dcda1fc108097","features","last_pulled","2026-09-22T01:50:21.560588064Z","last_pushed","2016-03-07T09:38:52Z","os","os_features","os_version","size",218078925,"variant","2016-03-07T09:38:52.349075Z","last_updater","last_updater_username","media_type","latest","repository",565049,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_107":40,"_108":109,"_110":143,"_86":144,"_113":145,"_46":151,"_132":109,"_133":29,"_134":52,"_53":152,"_136":137,"_138":148,"_139":151,"_140":62,"_141":17},171963403,2309281,[146],{"_116":117,"_118":147,"_120":94,"_121":148,"_123":149,"_125":94,"_126":94,"_127":-5,"_128":150,"_59":62,"_130":-5},"sha256:6423e6b74b59995b31d891009f8b39371600064454f371cd870380bc3c83e413","2026-09-15T14:41:17.13628944Z","2016-03-15T08:32:54Z",171963691,"2016-03-15T08:32:54.24226Z","docker-deploy","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":164,"_171":172,"_160":185,"_186":11},{"_36":165,"_38":166,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":167,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":168,"_75":17,"_76":170,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":169},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_173":174,"_175":-5,"_176":-5,"_177":178},"count",2,"next","previous","results",[179,182],{"_107":40,"_108":109,"_110":143,"_86":144,"_113":180,"_46":151,"_132":109,"_133":29,"_134":52,"_53":152,"_136":137,"_138":148,"_139":151,"_140":62,"_141":17},[181],{"_116":117,"_118":147,"_120":94,"_121":148,"_123":149,"_125":94,"_126":94,"_127":-5,"_128":150,"_59":62,"_130":-5},{"_107":40,"_108":109,"_110":111,"_86":112,"_113":183,"_46":131,"_132":109,"_133":29,"_134":52,"_53":135,"_136":137,"_138":122,"_139":131,"_140":62,"_141":17},[184],{"_116":117,"_118":119,"_120":94,"_121":122,"_123":124,"_125":94,"_126":94,"_127":-5,"_128":129,"_59":62,"_130":-5},[],"canDeleteTags","actionData","errors"]

smartercleanup/nginx

Tags for smartercleanup/nginx