Set up MkDocs 🛠️ To use MkDocs, you’ll need Python 3.6+ installed on your system, as well as the Python package manager, pip.While you install MkDocs, you should also pick a theme. Here, we picked the material theme. Thanks to Martin Donath!
Installation 1$ pip install --upgrade pip 2$ pip install mkdocs 3$ pip install mkdocs-material 4$ pip install pymdown-extensions 5---> 100% 6Successfully installed mkdocs, mkdocs-material Create New Site Now we are ready to create new project, run the blow command to create a new project.
1$ mkdocs new website 2---> 100% 3INFO - Creating project directory: website 4INFO - Writing config file: website\mkdocs.yml 5INFO - Writing initial docs: website\docs\index.md There’s a single configuration file named mkdocs.yml, and a folder named docs that will contain your documentation source files.
1| mkdocs.yml 2| 3\---docs 4 index.md Preview your Site MkDocs comes with a built-in devlopment server that lets you preview your website as you work on it.……
There are web services that you can quickly build and deploy with MkDocs.Do you know of web services that have not been added here? Please add! Cloudflare Pages https://pages.cloudflare.com/ Cloudflare Pages includes Mkdocs in their Build configuration:\ https://developers.cloudflare.com/pages/platform/build-configuration Add the following files to your MkDocs: requirements.txt:\ Please include the required pip package 1mkdocs 2mkdocs-bootswatch 3mkdocs-minify-plugin runtime.txt: You can also refer to this:\ https://github.com/fu-sen/CloudflarePages-MkDocs Cloudflare Workers (Workers Site) https://developers.cloudflare.com/workers/platform/sites Edit wrangler.toml: After that: 1mkdocs build 2wrangler publish Docker-based web service (Google Cloud Run, Fly.io, etc.) Google Cloud Run: https://cloud.google.com/run Fly (fly.io): https://fly.io/ Caddy is adopted as the Web server on the assumption that the Web will be open to the public.\ You should not use mkdocs serve for public release! Dockerfile: 1FROM python:3-slim as mkdocs 2COPY . . 3RUN pip install --no-cache-dir -r requirements.txt 4RUN mkdocs build 5FROM caddy:alpine 6COPY --from=mkdocs……
软件架构微服务化后,虽然软件间的耦合性更好了,不过在出现问题后,增加了定位问题的困难,所以就出现了 Correlation ID 来方便问题定位。首先我们看下关于 Correlation ID 在流程中的传输过程如下图:的定义描述。 The correlation identifier is a unique identifier attached to each request in architecture. The correlation ID is not an error number or code. Simply, it’s a GUID (globally unique identifier) that’s automatically generated for every request. There is no standard format for the correlation……