Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

"out of the box" configuration no longer works.

Đang mở
#326 5 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 2 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
35/100
Loại issue
Lỗi
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Đình trệ
Công nghệ
apache, debian
Lĩnh vực
devops, documentation

Hướng nghiên cứu

Bắt đầu bằng cách đọc README.rst và so sánh renderd.conf đã được cài đặt của Debian 11 với /usr/share/doc/renderd/examples/renderd-example-map.conf trên Debian 12. Kiểm tra những tệp cấu hình nào thực sự được cài đặt bởi lệnh cài đặt apt được đề xuất. Công việc được xem là hoàn tất khi Debian 12 có một cấu hình chung hoạt động được và README.rst phân biệt rõ ràng việc cài đặt từ repository, việc build từ mã nguồn và cấu hình thủ công bắt buộc.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Previously on Debian 11 and Ubuntu 22.04 installation "just worked" with an out-of-the-box configuration. That's one of the reasons that https://switch2osm.org/serving-tiles/manually-building-a-tile-server-debian-11/ and https://switch2osm.org/serving-tiles/manually-building-a-tile-server-ubuntu-22-04-lts/ were much shorter than previous versions. Unfortunately, there seems to have been a regression.

https://packages.debian.org/search?suite=bullseye&arch=any&mode=path&searchon=contents&keywords=renderd.conf shows that the renderd.conf for mod_tile was present in Debian 11 but https://packages.debian.org/search?suite=bookworm&arch=any&mode=path&searchon=contents&keywords=renderd.conf shows that it is missing in Debian 12. This doesn't seem to be a Debian packaging issue but instead a change here.

The replacement config seems to be in "/usr/share/doc/renderd/examples/renderd-example-map.conf", but that has a bunch of other things in it that won't work for 99% of people like port numbers and a hardcoded path "/var/www/example-map/".

https://github.com/openstreetmap/mod_tile/blob/master/README.rst is now completely muddled. It mixes up installing from the OS's repository (which "just works" on Debian 11 and Ubuntu 22.04 but fails on Debian 12), building from scratch (which also "just works" on Ubuntu 22.04 at least) and configuration (essentially unnecessary on Debian 11 and Ubuntu 22.04, some but not all sections required on Debian 12). The parts of https://github.com/openstreetmap/mod_tile/blob/master/README.rst that need to be manually executed refer to files that are not actually installed (at least not by the "apt install libapache2-mod-tile renderd" suggested earlier).

As a stopgap, I'll try put something together for Debian 12 that tries to simplify the manual tinkering required as much as possible (for the Debian 12 version of https://switch2osm.org/serving-tiles/manually-building-a-tile-server-ubuntu-22-04-lts/ ), but would it be possible to revert to a "working out of the box" configuration in time for the next LTS release? Essentially, restore the vanilla /etc/apache2/conf-available/renderd.conf from https://packages.debian.org/search?suite=bullseye&arch=any&mode=path&searchon=contents&keywords=renderd.conf without "example" settings that won't work for most people, and undo any other similar changes.

Ngôn ngữ chính
C++
Star
318
Fork
200
Merge trung bình
2 ngày 22 giờ
Pull request đã merge (30 ngày)
22

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của openstreetmap/mod_tile

Tất cả issue của openstreetmap/mod_tile

Issue tương tự

Thêm issue về C++

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.