Skip to content

Latest commit

 

History

History
85 lines (64 loc) · 4.43 KB

README.md

File metadata and controls

85 lines (64 loc) · 4.43 KB
Raw

페미위키 미디어위키 서버 Github checks Status

한국의 페미니즘 위키인 femiwiki.com에 사용되는 미디어위키 서버입니다. Nomad, Consul,Terraform 등에 필요한 다양한 코드를 담고있습니다. 데이터베이스와 memcached, 백업봇이 실행됩니다.

Development

아래와 같이 간편하게 페미위키를 로컬에서 실행할 수 있습니다.

sudo nomad agent -dev-connect -config nomad/development.hcl
consul agent -dev
nomad job run jobs/development/mysql.nomad
nomad job run jobs/development/memcached.nomad
nomad job run jobs/development/fastcgi.nomad
nomad job run jobs/development/http.nomad

이후 브라우저에서 [http://localhost:8080]를 방문할 수 있습니다.

Production

페미위키는 프로덕션 배포에도 Nomad를 사용하고 있으며 이를 위해 Nomad Provider와 Terraform Cloud를 사용하고 있습니다. 그러면 서버에 Nomad를 준비하고 Terraform Cloud와 연결하는 작업이 필요합니다.

서버에는 다음 소프트웨어가 필요합니다.

  • Docker
  • Nomad
  • Consul
  • CNI network plugins

설치 후엔 이 리포지토리에 정의된 각 소프트웨어의 설정들을 적용해야 합니다.

git clone https://github.com/femiwiki/nomad.git
cd nomad
sudo ./up

이상의 과정은 실제로는 femiwiki/infra에 저장된 스크립트를 통해 인스턴스 Launch 후 자동으로 실행됩니다.

수작업으로는 Terraform Cloud와 Nomad cluster를 연결하기 위해 ACL을 시작하고 생성된 토큰을 Terraform Cloud에 저장하는 과정이 필요합니다. 다음을 실행해주세요.

$ ./nomad-acl-bootstrap
Nomad ACL Secret ID = 9184ec35-65d4-9258-61e3-0c066d0a45c5

nomad-acl-bootstrap은 nomad acl bootstrap을 실행하고 NOMAD_TOKEN으로 쓸 수 있는 Secret ID를 출력하면서 .bashrc에 환경 변수 설정을 추가합니다. 출력된 Secret ID를 terraform cloud femiwiki/nomad workspace의 Variables 설정에서 nomad_token으로 입력해주세요.

Nomad 업그레이드

노드가 하나 뿐인 현재 세팅에서 Nomad를 업그레이드 해야 할 때는 다운타임을 가지고 수작업으로 모든 서비스를 내린 후 다시 생성하는 방법을 사용하여야 합니다. 단순히 바이너리만 교체할 경우 구 버전의 Nomad가 실행한 컨테이너가 추적되지 않아 새 Nomad가 띄우려고 하는 컨테이너와 포트 등이 충돌한 경험이 있습니다.

  1. nomad job stop -purge <NAME>으로 fastcgi, mysql, http 등의 서비스를 내린다.
  2. nomad node status로 node ID를 알아낸다.
  3. 볼륨들을 모두 제거한다. (nomad volume detach mysql <NODE_ID>; nomad volume detach caddycerts <NODE_ID> → nomad volume deregister) 만일 aws-ebs0를 먼저 제거했다면 볼륨에 대한 작업을 할 수 없으므로 다시 살려야 한다.
  4. 남은 모든 서비스를 내린다.
  5. 스크립트를 참고해 바이너리를 교체한다.
  6. ~/nomad 디렉토리를 원하는 git 트리로 체크아웃한다.
  7. aws-ebs-csi-driver를 nomad job run jobs/plugin-ebs-controller.nomad; nomad job run jobs/plugin-ebs-nodes.nomad로 올린다. depends_on이 꼬여서 미리 실행하지 않으면 #73 문제가 발생한다.
  8. nomad plugin status로 플러그인 상태를 확인한다.
  9. 테라폼 클라우드로 나머지를 모두 올린다.

The source code of femiwiki/mediawiki is primarily distributed under the terms of the GNU Affero General Public License v3.0 or any later version. See COPYRIGHT for details.