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 compose, it allows users to configure their applications and access them through an NGINX reverse proxy, which directs requests to the appropriate service. Certificates will be deployed by us. The content for hosted websites will be available on an NFS share, which you can access.

Available Services

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

How to Use the Service

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

1. Prepare Your Service

   • Ensure your service is running in one or more Docker container.

2. Create a Branch or Fork

   • Navigate to the repository: WebHosting

3. Edit the Docker Configuration

   • Update the docker-compose.yaml file in the repository to include you service container(s).
   • Add a configuration file for your service to the conf.d directory, specifying proxy_pass with the container's name as defined in docker-compose.yaml to route requests properly through the nginx reverse proxy to your container(s).

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.

Additional Information

• Backup Schedule

  • Elog 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.