/docker-templates

Primary LanguagePHP

Background

This repository acts a reference for those who wish to see simple examples of how to containerize (in this case, with docker) various languages. Since applications hosted in containers have been growing in popularity, I've found myself reimplementing the same flavor of Dockerfile. Specifically the ability to serve static client files (HTML, Javascript). Although this type of container doesn't always make sense in a production environment, I've found it useful for development environments

Approach

All examples contained here are contrived examples of "Hello World" with the possibility of extras, usually to try to incorporate another library or framework

Almost all of FROM images are alpine because of how small the resulting container is.

Lessons Learned

In some cases, if you're porting an existing application to docker, you may find yourself needing to run multiple services in the same container, although it's not preferred there are tricks to help you support this functionality, specifically supervisord:

Trying to serve client asseste behind from behind a kubernetes ingress controller has been very trying. Why would you want to do that? Well, because I don't want to pay for cloud infra, and i can learn a lot locally anyway. So far the most progress i've been able to make is in the laravel project where i'm trying to tell apache2 to NOT rewrite URLs the ingress controller is proxying to it. This is what is happening:

  • browser url: localhost/phplaravel9svc/hello-world/
  • nginxingress directs traffic to phplaravel9svc:8009/hello-world/ (port-forwarded to :80)
  • apache rewrites to localhost/hello-world/
    • nginx doesnt know what to do with this resulting URL, so responds with a 404

I think the main trick here, is to comment out the only rule in the .htacess file that had a 301 redirect

  • shrugs....
  • It was a little more involved. I left the file in php-laravel9/public/.htaccess intact, with only one rule uncommented

Running

Docker:

  • each template folder should have an example folder, change to this directory and take a look at the Readme in that directory

Docker-compose:

  • from the repository root, run:
    • docker compose build
    • docker compose up

Kubernetes:

  • this method requires two cli tools:
    • kubectl
    • kompose
  • https://kubernetes.github.io/ingress-nginx/deploy/#quick-start
  • from the root of the repository run: 
    • kompose convert -o kubernetes

    • kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/controller-v1.1.1/deploy/static/provider/cloud/deploy.yaml

    • kubectl apply -f $(ls -p kubernetes/*.yaml | xargs | tr ' ' ',')

    • kubectl delete -f $(ls -p kubernetes/*.yaml | xargs | tr ' ' ',')