envoy website

Envoy 프록시 웹 사이트

이것은 Envoy Proxy 웹 사이트의 저장소입니다.

이 웹 사이트는 Jekyll 및 Sphinx를 사용하여 구축하여 정적 HTML 파일을 생성 한 다음 NetLify와 함께 배포됩니다.

호스트 개발 시스템에서 Bazel 사용

호스트 시스템에 Bazel이 설치된 경우 사이트를 직접 관리하고 개발하는 데 사용할 수 있습니다.

바젤의 예상 버전은 .bazelversion에서 볼 수 있습니다.

호스트에서 바젤을 직접 사용하는 경우 최소 시스템 요구 사항이 필요합니다. 이러한 요구 사항은 제공된 Dockerfile의 Ubuntu 기반 시스템에 대해 볼 수 있습니다.

Docker 컨테이너에서 Bazel 사용

Docker 컨테이너 내부에서 필요한 바젤 명령을 실행할 수도 있습니다.

Bazel에서 예상되는 시스템 요구 사항을 포함하는 Docker 이미지를 사용하는 편의를 위해 Docker-Compose 파일이 제공되었습니다.

이 구성은 호스트 시스템에서 바젤 캐시를 사용하도록 설계되었습니다.

컨테이너를 실행하려면 사용자의 UID 내보내야 할 수도 있습니다.

$ export UID

바젤 루비 도구 체인

Ruby가 웹 사이트를 구축해야하므로 Ruby 도구 체인이 Bazel 규칙에 포함되어 있습니다.

이것은 환경에서 사용 가능한 루비 바이너리를 찾을 것입니다.

.Ruby-Version에 지정된 버전과 일치하는 버전을 찾으면 해당 버전을 사용합니다.

그렇지 않으면 추가로 사용하기 위해 필요한 루비 버전을 컴파일하여 바이너리를 캐싱합니다.

Docker 컨테이너 내부에서 Bazel 명령을 실행하면 이전에 컴파일 된 버전을 찾지 않는 한 Ruby를 컴파일해야합니다.

로컬로 라이브 사이트 실행 (Bazel)

$ bazel run //site:live

http : // localhost : 4000을 방문하여 사이트를 사용할 수 있어야합니다.

기본적으로 문서가 아닌 웹 사이트만이 환경에서 제공됩니다.

최신 문서로 구축 된 전체 사이트를 다음과 같이 볼 수 있습니다.

$ export ENVOY_COMMIT= " $( bazel run //docs:latest_version ) "
$ bazel run --action_env=ENVOY_COMMIT //site:live_docs

밑줄이 정한 Jekyll 폴더의 컨텐츠 변경으로 즉각적인 서버 재 장전이 트리거됩니다.

로컬로 사이트 실행 (Docker)

제공된 Compose 레시피와 함께 Docker 컨테이너 내부에서 웹 사이트를 실행할 수 있습니다.

$ docker-compose up live

기본적으로 문서가 아닌 웹 사이트만이 환경에서 제공됩니다.

최신 문서로 구축 된 전체 사이트를 다음과 같이 볼 수 있습니다.

$ docker-compose up live_docs

밑줄이 정한 Jekyll 폴더의 컨텐츠 변경으로 즉각적인 서버 재 장전이 트리거됩니다.

현지 사이트 구축 (바젤)

전체 웹 사이트를 구축하기위한 바젤 목표는 다음과 같습니다.

$ export ENVOY_COMMIT= " $( bazel run //docs:latest_version ) "
$ bazel build --action_env=ENVOY_COMMIT //site:html

현재 디렉토리의 _site 폴더로 빌드 할 편의 스크립트 (CI에서 사용)가 있습니다.

$ ./build-website.sh

현지 사이트 구축 (Docker)

다음 명령은 모든 문서를 포함한 전체 웹 사이트를 현재 디렉토리의 _site 폴더로 빌드합니다.

$ docker-compose run build

컨테이너 내부에서 바젤 명령을 실행합니다.

작곡 파일에 구성된 포트 매핑을 사용하여 Docker 컨테이너에 떨어 뜨리려면 다음과 같습니다.

$ docker-compose run -p 4000:4000 live bash

여기에서 바젤 명령을 직접 실행할 수 있습니다.

 username@73deecbfaf55:/src/workspace/envoy-website $ bazel run //docs:latest_version
...
b200312ddcbc4d237cd197a42cdd8c66cc8c6af0

사이트 컨텐츠

목	길
홈페이지 컨텐츠	_data/home.yml
메인 페이지의 NAV 링크	_data/nav.yml
문서 (자동 생성)	docs

새 페이지 만들기

새 페이지를 만들려면 루트 디렉토리에 새 파일을 작성하기 만하면됩니다. 이 파일은 Markdown 파일 또는 HTML 파일 일 수 있습니다.

새 파일에는 Jekyll이 Front Matter라고 부르는 내용이 포함되어 있어야합니다. 여기에는 템플릿, 퍼머 링크 및 페이지 제목과 같은 옵션을 설정할 수 있습니다.

Envoy 채택 자로고를 추가하십시오

Envoy는 프로덕션에서 소프트웨어를 사용하는 프로젝트를 인식하게되어 기쁩니다. 이것들은 광고가 아니라 프로젝트에 대한 지원을 보여줍니다. 모든 지원 조직은 알파벳 순서로 표시됩니다. 채택 자 목록에 추가하려면 다음과 같은 기준을 충족해야합니다.

• 커뮤니티의 참가자이자 적극적인 기고자가되면 코드, 문제를 후원하거나 EnvoyCon을 후원 할 수 있습니다.
• 대화, 블로그 CNCF 사례 연구 또는 소셜 미디어를 통해 Evoy 사용을 공개적으로 공개
• 고품질 그레이 스케일 벡터 SVG 로고 제출, 우리는 높이를 52px로 확장합니다 (예 참조).
• 기존 사절 관리자 보증을 받고 풀 요청을 승인하십시오.

로고를 추가하려면 풀 요청을 보내십시오 (이 예제 참조).

Envoy 블로그

공식 Envoy 블로그는 https://blog.envoyproxy.io에서 매체에서 호스팅됩니다.