baibgj/ceph repository overview

⁠Quick reference

• The official uWSGI docker image.

• Maintained by: openEuler CloudNative SIG⁠.

• Where to get help: openEuler CloudNative SIG⁠, openEuler⁠.

⁠uWSGI | openEuler

Current uWSGI docker images are built on the openEuler⁠. This repository is free to use and exempted from per-user rate limits.

uWSGI is an open source software application that "aims at developing a full stack for building hosting services". It is named after the Web Server Gateway Interface (WSGI), which was the first plugin supported by the project. uWSGI is maintained by the Italian-based software company unbit.

⁠Supported tags and respective Dockerfile links

The tag of each uwsgi docker image is consist of the version of uwsgi and the version of basic image. The details are as follows

⁠Usage

In this usage, users can select the corresponding {Tag} based on their requirements.

• Pull the openeuler/uwsgi image from docker

  docker pull openeuler/uwsgi:{Tag}
  

  Copy

• Run with an interactive shell

  You can start the container with an interactive shell to use uwsgi.

  docker run -it --rm openeuler/uwsgi:{Tag} bash
  

  Copy

• Prepare tne Application

  Create Working Directory

  mkdir /app
  

  Copy

  Create WSGI Entry File(myapp.py)

  # /app/myapp.py
  def application(environ, start_response):
      status = '200 OK'
      headers = [('Content-type', 'text/plain; charset=utf-8')]
      start_response(status, headers)
      return [b"Hello World from uWSGI!"]
  

  Copy

• Set Up Non-Root User & Permissions

  Create Dedicated User & Group

  groupadd -r uwsgi_group
  useradd -r -g uwsgi_group -d /app -s /bin/false uwsgi_user
  

  Copy

  Set Proper Permissions

  chown -R uwsgi_user:uwsgi_group /app
  chmod -R 755 /app
  

  Copy

• Start uWSGI with Recommended Parameters

  Basic Command

  ./uwsgi \
    --http-socket :8000 \
    --processes 4 \
    --threads 2 \
    --chdir /app \
    --wsgi-file myapp.py \
    --master \
    --enable-threads \
    --buffer-size 32768 \
    --uid uwsgi_user \
    --gid uwsgi_group
  
  **Parameters Explanation**:
  
  | Parameter | Description | Recommended Value |
  |----------|-------------|------------------|
  | `--http-socket :8000` | Bind to TCP port 8000 (HTTP mode) | `:8000` (or any available port) |
  
  

  Copy

⁠Question and answering

If you have any questions or want to use some special features, please submit an issue or a pull request on openeuler-docker-images⁠.