mkdocs 사본을 실행하여 Rocky Linux 문서가 실제 시스템에 통합될 때 어떻게 표시되는지 정확히 확인할 수 있는 여러 가지 방법이 있습니다. 이 특정 문서는 로컬 워크스테이션에서 LXD 컨테이너를 사용하여 mkdocs의 Python 코드를 다른 프로젝트와 분리하는 방법에 대해 다룹니다.
첫 번째 단계는 LXD 컨테이너를 생성하는 것입니다. 여기서는 컨테이너의 기본값(브리지 인터페이스)을 사용하면 됩니다.
mkdocs용 Rocky 컨테이너를 워크스테이션에 추가합니다. "mkdocs"라고 이름을 지정합니다.
lxc launch images:rockylinux/8 mkdocs
컨테이너는 프록시여야 합니다. 기본적으로 mkdocs serve가 시작되면 127.0.0.1:8000에서 실행됩니다. 이는 컨테이너 없이 로컬 워크스테이션에서 수행할 때는 괜찮습니다. 그러나 로컬 워크스테이션의 LXD 컨테이너에 있는 경우 컨테이너를 프록시 포트로 설정해야 합니다. 다음 명령으로 이 작업을 수행하세요.
두 개의 저장소를 클론해야 합니다. 그러나 git 원격(remote)를 추가할 필요는 없습니다. 여기의 문서 저장소는 현재의 문서를 표시합니다(로컬 워크스테이션에서 복제된 것) 및 docs입니다.
rockylinux.org 저장소는 mkdocs serve를 실행하고 그 소스로 미러를 사용합니다. 이 모든 단계는 비루트 사용자로 실행하세요. 이 단계에서 userid로 저장소를 클론할 수 없다면 git에 대한 당신의 신원과 관련하여 문제가 있습니다. 앞의 몇 단계를 검토하여 키 환경을 재생성해야 합니다.
이제 mkdocs를 설정했으므로 서버를 시작해 보세요. 이 프로세스는 production으로 보입니다만 그렇지 않습니다. 그러므로 경고를 무시하세요. 다음과 같이 mkdocs serve를 시작합니다.
mkdocs serve -a 0.0.0.0:8000
콘솔에 다음과 유사한 내용이 표시됩니다.
INFO - Building documentation...
WARNING - Config value: 'dev_addr'. Warning: The use of the IP address '0.0.0.0' suggests a production environment or the use of a
proxy to connect to the MkDocs server. However, the MkDocs' server is intended for local development purposes only. Please
use a third party production-ready server instead.
INFO - Adding 'sv' to the 'plugins.search.lang' option
INFO - Adding 'it' to the 'plugins.search.lang' option
INFO - Adding 'es' to the 'plugins.search.lang' option
INFO - Adding 'ja' to the 'plugins.search.lang' option
INFO - Adding 'fr' to the 'plugins.search.lang' option
INFO - Adding 'pt' to the 'plugins.search.lang' option
WARNING - Language 'zh' is not supported by lunr.js, not setting it in the 'plugins.search.lang' option
INFO - Adding 'de' to the 'plugins.search.lang' option
INFO - Building en documentation
INFO - Building de documentation
INFO - Building fr documentation
INFO - Building es documentation
INFO - Building it documentation
INFO - Building ja documentation
INFO - Building zh documentation
INFO - Building sv documentation
INFO - Building pt documentation
INFO - [14:12:56] Reloading browsers
이제 이 순간이 참이 되었습니다! 모든 것을 올바르게 수행했다면 웹 브라우저를 열고 컨테이너의 IP와 포트 :8000으로 이동하여 문서 사이트를 확인할 수 있어야 합니다.
위 예제에서는 웹 브라우저 주소에 다음을 입력합니다. (참고 깨진 URL을 피하기 위해 여기서 IP는 "your-server-ip"로 변경되었습니다. 실제로는 해당 IP로 바꾸시면 됩니다.)
웹 브라우저에서 문서를 보았다면 거의 완료되었습니다. 마지막 단계는 컨테이너의 문서를 로컬 워크스테이션의 문서와 동기화하는 것입니다.
이를 위해 이전에 언급한대로 lsyncd를 사용합니다.
lsyncd의 설치 방법은 사용하는 리눅스 버전에 따라 다릅니다. 이 문서에는 Rocky Linux에 설치하는 방법과 소스에서 설치하는 방법이 나와 있습니다. 다른 리눅스 종류를 사용하고 있다면(예: Ubuntu), 일반적으로 해당 플랫폼용 패키지가 있지만 세부적인 사항이 있을 수 있습니다.
예를 들어 Ubuntu의 경우 구성 파일의 이름이 다를 수 있습니다. 그냥 명심하세요. 다른 Rocky Linux 워크스테이션 타입을 사용하고 소스에서 설치하고 싶지 않다면, 해당 플랫폼용 패키지가 있을 가능성이 높습니다.
이제 Rocky Linux 워크스테이션을 사용하고 있고 포함된 문서에 있는 RPM 설치 방법을 사용한다고 가정합니다.