server - GitLite

KO | EN

gitlite — search

#javascript #python #ai #typescript #llm #go #android #machine-learning #linux #macos #java #cli #kubernetes #security

server

(★ 86)

No description available.

파일 탐색기

최종 버전 다운로드 (.zip)

- - easyp_build.yml
  - security.yml
  - test.yml
- - ARCHITECTURE.md
  - CONCERNS.md
  - CONVENTIONS.md
  - INTEGRATIONS.md
  - REVIEW.md
  - STACK.md
  - STRUCTURE.md
  - TESTING.md
- - buf-cid-ref-forwarded-to-upstream.md
  - buf-v1-graph-format.md
  - buf-v1-owner-route-missing.md
  - buf-v2-content-type.md
  - download-foreign-commit-id.md
  - improve-prod-debug-logs.md
- - v1.2-REQUIREMENTS.md
  - v1.2-ROADMAP.md
- - ARCHITECTURE.md
  - FEATURES.md
  - PITFALLS.md
  - STACK.md
  - SUMMARY.md
- agent-history.json
- config.json
- MILESTONES.md
- PROJECT.md
- REQUIREMENTS.md
- RETROSPECTIVE.md
- ROADMAP.md
- STATE.md
- - buf
  - protobuf
- - .gitignore
  - buf.gen.yaml
  - generate.go
- buf.work.yaml
- - main.go
  - main_test.go
- - bufbin.go
  - config.go
  - server.go
  - testutil_test.go
- all_versions_test.go
- generate_test.go
- new_proto_test.go
- old_proto_test.go
- ref_test.go
- smoke_test.go
- - api.go
  - api_test.go
  - blobs.go
  - blobs_test.go
  - bynames.go
  - bynames_test.go
  - commits.go
  - commits_helpers.go
  - commits_helpers_test.go
  - interceptor.go
  - modulepins.go
  - modulepins_test.go
  - owners.go
  - uuid_format_test.go
  - validate.go
- - https.go
- - reqid.go
  - reqid_test.go
- - hash.go
- build.sh
- clone_repos.sh
- publish.sh
- push_stage_to_docker.sh
- cert.pem
- key.pem
.gitignore
.gitmodules
.golangci.yml
.mise.toml
CHANGELOG.md
Dockerfile
go.mod
go.sum
LICENSE
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/easyp-tech/server

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd server

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker build -t server .

Dockerfile을 기반으로 실행 가능한 이미지를 빌드합니다.

docker run -p 8080:80 server

빌드된 이미지를 실제 컨테이너로 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

3. Go

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

go build ./...

Go 프로그램을 컴파일해 실행 파일을 만듭니다.

go run .

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# easyp-server

* [easyp-server](#easyp-server)
* [TODO:](#todo)
  * [Features](#features)
  * [Installation](#installation)
    * [Steps](#steps)
      * [Repository Setup](#repository-setup)
      * [Service Configuration](#service-configuration)
      * [`buf` configuration](#buf-configuration-)

# TODO:

* Elaborate on the roadmap

A backward-compatible server for working with the CLI tool [buf](https://github.com/bufbuild/buf).

## Features

* Support for the package manager with `buf mod update`

## Installation

### Steps

#### Repository Setup

```bash
wget https://raw.githubusercontent.com/easyp-tech/server/refs/heads/main/scripts/clone_repos.sh -O clone_repos.sh
```
```bash
chmod +x clone_repos.sh
```
```bash
./clone_repos.sh https://github.com/googleapis/googleapis.git https://github.com/bufbuild/protovalidate.git
```

#### Service Configuration

Create a service configuration file, replace easyp.tech with your domain:

```yaml
# address the service will be listening
listen:  127.0.0.1:8080

# domain the service will be accessible.
# Note: buf requires TLS, so this is a name your cert is assigned.
domain:  easyp.tech:8080

# set up log level
# Note: info level is default.
log:
  level: "info" # debug, info, warning(or warn), error

# Cache configuration
cache:
  # Cache type: none | local | artifactory
  # none means no cache, local means caching in the local directory
  # artifactory - surprise - means cache placed on the artifactory server
  # local/artifactory are configured with the corresponding sections below
  # Note: googleapis downloading from GitHub take about 40 sec,
  # so cache might be considered useful.
  type: none
  local:
    # directory where the cache will be placed.
    directory: ./.storage/.cache
  artifactory:
    token: some_artifactory_access_token
    user:  some_username
    url:   https://some.artifactory.url/with/read/write/access

# TLS config, required by buf.
tls:
  cert: cert.pem
  key:  key.pem
  #ca:   ca.pem

# Processing order:
# 1. check if the local mirror exists and use it if so
# 2. pass all the other to the GitHub proxy

# Locally mirrored git repos settings.
local:
  # Path to find the local git mirrors.
  # Mirrors must be os owner/repository subdir in this dir.
  # Local mirrors have the highest priority:
  # the server's response will be based on it if it is detected.  
  # Note: write access is required as the service will switch commits then needed.
  storage: ./.storage/gitlocal
  # Settings applied to the locally mirrored repos.
  # Mirrors not mentioned are processed as with empty config,
  # which is Ok for most cases.
  repo:
    - owner: googleapis
      name:  googleapis
      path:
        - google/type/
        - google/api/
        - google/rpc/
    - owner: bufbuild
      name:  protovalidate
      prefix:
        - proto/protovalidate/
    - owner: grpc-ecosystem
      name:  grpc-gateway
      path:
        - protoc-gen-openapiv2/

# Proxy config
# GitHub API only at the moment
proxy:
  # list of the repos will be proxied to BitBucket using API v1.
  bitbucket:
    # BitBucket API access token, generate your own.
    # You can go without token, but access rate will be really limited.
    # BitBucket repos are the second priority.
    - token: some_bitbucket_access_token
      user:  some_username
      url:   https://some.bitbucket.url/repo/is/accessible
      # Repository details
      repo:
        owner: googleapis
        name:  googleapis
        # googleapis is huge.
        # Fortunately we do not need to get all the files to make it works.
        # So path is a list of prefixes for the files really required.
        # Note: trailing slash is essential. Leading slash is prohibited.
        path:
          - google/type/
          - google/api/
          - google/rpc/
    - token: some_bitbucket_access_token
      user: some_username
      url:   https://some.bitbucket.url/repo/is/accessible
      repo:
        owner: bufbuild
        name:  protovalidate
        # prefix is similar to path,
        # it is used to distinguish the files we really want to get.
        # but prefix will be cut off from the proxied file name.
        # it might be required for some repos, like bufbuild/protovalidate
        # Note: trailing slash is essential. Leading slash is prohibited.
        prefix:
          - proto/protovalidate/
    - token: some_bitbucket_access_token
      user: some_username
      url:   https://some.bitbucket.url/repo/is/accessible
      repo:
        owner: grpc-ecosystem
        name:  grpc-gateway
        path:
          - protoc-gen-openapiv2/

# list of the repos will be proxied to GitHub.
  github:
    # GitHub API access token, generate your own.
    # You can go without token, but access rate will be really limited.
    # GitHub repos are the last priority.
    - token: some_github_token 
      # Repository details
      repo:
        owner: googleapis
        name:  googleapis
        # googleapis is huge.
        # Fortunately we do not need to get all the files to make it works.
        # So path is a list of prefixes for the files really required.
        # Note: trailing slash is essential. Leading slash is prohibited.
        path:
          - google/type/
          - google/api/
          - google/rpc/
    - token: some_github_token
      repo:
        owner: bufbuild
        name:  protovalidate
        # prefix is similar to path,
        # it is used to distinguish the files we really want to get.
        # but prefix will be cut off from the proxied file name.
        # it might be required for some repos, like bufbuild/protovalidate
        # Note: trailing slash is essential. Leading slash is prohibited.
        prefix:
          - proto/protovalidate/
    - token: some_github_token
      repo:
        owner: grpc-ecosystem
        name:  grpc-gateway
        path:
          - protoc-gen-openapiv2/
```

Note that config values can be set to env vars. Easyp will attempt to substitute them with the values from the current environment. If variable is unset, it will be replaced with an empty string. Example:

```yaml
# address the service will be listening
listen: ${EASYP_LISTEN}
```

#### `buf` configuration

Essential part of `buf.yaml`:

```yaml
deps:
  - easyp.tech:8080/bufbuild/protovalidate
  - easyp.tech:8080/grpc-ecosystem/grpc-gateway
  - easyp.tech:8080/googleapis/googleapis
```

#### Simple Health Check

```bash
https://you-address

Hello! This is Buf Proxy Service and this is its Health Check!
```