gin-framework

(★ 287)

:zap::rocket: Based on the gin framework, we have developed a user-friendly, simple, and fast development framework for API programming using go1.18+

파일 탐색기

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

- boot.go
- - consumer.go
  - producer.go
- admin.go
- command.go
- controller.go
- migrate.go
- model.go
- service.go
- - config.dev.yaml
  - config.prod.yaml
  - config.test.yaml
- config.go
- white_list.go
- - context.go
- vars.go
- casbin_auth.go
- cors_auth.go
- ip_auth.go
- login_auth.go
- rbac_model.conf
- requestid_auth.go
- 000001_create_users_table.down.sql
- 000001_create_users_table.up.sql
- 000002_create_admin_table.down.sql
- 000002_create_admin_table.up.sql
- 000003_create_users_info_table.down.sql
- 000003_create_users_info_table.up.sql
- 000004_create_casbin_rule_table.down.sql
- 000004_create_casbin_rule_table.up.sql
- 000005_create_gin_role_table.down.sql
- 000005_create_gin_role_table.up.sql
- casbin_rule.go
- gin_admin.go
- gin_role.go
- gin_user.go
- gin_user_info.go
- model.go
- - jwt.go
- - logger.go
  - mysql.go
  - redis.go
- - pagination.go
- - code.go
  - response.go
- - format_time.go
  - helper.go
  - node.go
  - ticker.go
  - tree.go
  - upload.go
- - validator.go
- - backend.go
  - common.go
  - frontend.go
- register.go
- index.html
- - admin.go
- - attachment.go
- - common.go
- - user.go
.air.toml
Dockerfile
go.mod
LICENSE
main.go
Makefile
README.md
README.zh_CN.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/MQEnergy/gin-framework

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

cd gin-framework

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

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Go go install 명령어를 쓰려면 Go가 필요합니다.
Homebrew macOS/Linux용 패키지 매니저입니다.
Scoop Windows용 패키지 매니저입니다.

go install github.com/cosmtrek/air@latest

지정된 버전을 바로 다운로드해서 설치합니다. 레포를 직접 클론할 필요가 없습니다.

brew install golang-migrate

Homebrew로 이미 빌드된 패키지를 바로 설치합니다. 소스 빌드가 필요 없습니다.

scoop install migrate

Scoop으로 바로 설치합니다 (Windows).

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Docker

쉬움

사전 준비물

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

docker build -t gin-framework .

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

docker run -p 8080:80 gin-framework

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

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

4. Go

보통

사전 준비물

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

go run main.go

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

go run main.go --help

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

go install github.com/cosmtrek/air@latest

지정된 버전을 바로 다운로드해서 설치합니다. 레포를 직접 클론할 필요가 없습니다.

go run main.go migrate -s=all

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

go run main.go migrate -help

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

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

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

5. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make help