gitea-pages/services/admin-guide/webhosting.md

WebHosting

WebHosting is a service for running simple web apps without the need to operate and maintain a virtual machine. Based on Docker, it allows users to configure their applications and access them through an NGINX reverse proxy, which directs requests to the appropriate service. Each service has a configuration file inside conf.d. Currently, certificates are deployed by the Linux engineering team until an automated ACME solution becomes available. The content for hosted websites will be available on an NFS share, which you can access.

How to Use the Service

1. Prepare Your Service

   • Ensure your service is running in a Docker container.

2. Create a Branch or Fork

   • Navigate to the repository: WebHosting

3. Edit the Docker Configuration

   • Update the docker-compose.yaml file located in the repository with the necessary configuration for your web server.
   • Add your web server configuration file to the conf.d directory (use proxy_pass with the container's name as specified in docker-compose.yaml).

4. Create a Merge Request

   • Submit a merge request in the WebHosting repository.

5. Contact Linux Engineering for Merge Approval

   • Email linux-eng to request the merge of your branch after review.
   • The team will handle certificate creation post-review.

6. Deployment

   • The service is automatically deployed upon merging to the main branch.

Note: If you need assistance at any step, reach out to linux-eng.

Additional Information

• Available Services

  • Elog is pre-configured as a container and can be ordered or configured by you.

• Backup Schedule

  • Logbooks are backed up hourly, retained for one week.
  • Other web content is backed up four times daily.

• Running Multiple Containers

  • For services needing multiple containers, we can create additional networks upon request.