refactor: docker directory structure

[germa89]

Description

This PR reorganizes the docker/ directory into a cleaner, more maintainable structure by separating files based on their purpose.

Changes

New Directory Structure

The docker/ directory has been reorganized into three subdirectories:

• docker/build/ - Contains files for building MAPDL Docker images:

  • Dockerfile
  • .dockerignore
  • make_container.rst (moved from docker/)

• docker/run/ - Contains files for running MAPDL containers:

  • docker-compose.yml (cleaned up to focus on MAPDL/DPF services with external license)
  • README.md (comprehensive usage documentation)
  • Template files for local license server setup (gitignored)

• docker/testing/ - Contains testing-related files (already existed):

  • README.md (new documentation)

Key Improvements

1. Better organization: Files are now grouped by functionality (build, run, test)
2. Cleaner docker-compose: The main docker-compose.yml focuses on MAPDL and DPF services with external license servers
3. Template support: Added templates for local license server configuration (which are gitignored)
4. Documentation: Added README files in each subdirectory explaining purpose and usage
5. Named compose project: Added name: pymapdl to docker-compose.yml for cleaner container naming

Documentation Updates

• Updated doc/source/getting_started/make_container.rst to reference new file locations
• Updated doc/source/links.rst with new docker-compose.yml path
• All references to moved files have been updated

Files Moved

• docker/Dockerfile → docker/build/Dockerfile
• docker/.dockerignore → docker/build/.dockerignore
• docker/make_container.rst → docker/build/make_container.rst
• docker/docker-compose.yml → docker/run/docker-compose.yml

Benefits

• Easier to find relevant files based on use case
• Clearer separation of concerns
• Better support for both public (repo) and private (local) configurations
• Improved documentation with directory-specific READMEs

[Copilot]

Pull Request Overview

This PR reorganizes the docker/ directory to improve maintainability and clarity by separating files based on their purpose: building images, running containers, and testing. The restructuring groups related files into docker/build/, docker/run/, and docker/testing/ subdirectories, updates the docker-compose configuration to be more focused and production-ready, and adds comprehensive documentation through README files in each subdirectory.

Key Changes

• Relocated Docker build files (Dockerfile, .dockerignore, make_container.rst) to docker/build/
• Moved docker-compose configuration to docker/run/ with simplified service definitions
• Enhanced docker-compose.yml with named project, cleaner service profiles, and improved documentation
• Updated all documentation references to reflect new file locations

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
docker/run/docker-compose.yml	New docker-compose configuration with external license server support, named project, and cleaner service definitions
docker/run/README.md	New documentation explaining usage patterns, available services, profiles, and environment variables
docker/make_container.rst	Removed file (moved to docker/build/)
docker/docker-compose.yml	Removed file (relocated to docker/run/)
docker/Dockerfile	Removed file (relocated to docker/build/)
docker/.dockerignore	Removed file (relocated to docker/build/)
doc/source/links.rst	Updated link to docker-compose.yml to point to new location
doc/source/getting_started/make_container.rst	Updated include path for make_container.rst to new build directory location

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 91.34%. Comparing base (45ead1e) to head (9e869b2).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4306      +/-   ##
==========================================
+ Coverage   91.31%   91.34%   +0.03%     
==========================================
  Files         193      193              
  Lines       15742    15742              
==========================================
+ Hits        14375    14380       +5     
+ Misses       1367     1362       -5     

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[germa89]

@pyansys-ci-bot LGTM.

[pyansys-ci-bot]

✅ Approving this PR because germa89 said so in here 😬