배우고 익힘/서버

Wiki.js로 컴백

White smoke 2022. 6. 19. 23:54

야심차게 XWIKI를 사용해보고자 했으나, 최소 요구사양이 높네. 나는 GCP free tier를 쓰고 싶으니 다시 원래대로 wiki.js로 컴백하자. 백업의 문제가 있는데 일단 git 연동에 실패했으니 그냥 스냅샷으로 만족해야겠다. wiki.js 3.0에서 좋아진다니 그 때까지 기다려봐야지.

설치 방법은 맨날 까먹는다. 적어놔야지 안되겠네.

  1. docker로 설치하는 게 최상이래서 그리 한다.
  2. git을 일단 설치는 한다. 연동을 실패하건 말건 일단 설치. 연동되면 짱짱맨일텐데.. docker로 컨테이너에서 사용되는 폴더가 어딘지를 몰르겠다.

Docker 설치

docker compose로 설치를 하던, 그냥 docker로 설치를 하던 따라하면 된다. 근데 따라하는 것만도 매우 버거웠다.

이번에 설치할 때는 그냥 docker로 설치하기로 했다. docker를 1도 이해하지 못한 상태에서 docker-compose는 더욱 이해하지 못했던 거 같아서. 설치 방법은 아래 링크를 따라했다.
Install on Ubuntu 18.04 / 20.04 / 22.04 LTS | Wiki.js (requarks.io)

 

Install on Ubuntu 18.04 / 20.04 / 22.04 LTS

Complete A to Z guide to setup a fully functioning Wiki.js installation

docs.requarks.io

내가 원하는 폴더에 설치하라고 했는데 이상하게 안됐다. 폴더 경로만 바꾼건데 왜 안되는거지... 삽질하다가 그냥 가이드에서 알려주는 경로대로 똑같이 따라해봤더니 실행이 돼버렸다.. 허허허

Git으로 storage 연동은 따라하라는대로 몇 번을 했는데 왜 안되는지 몰름.
Git | Wiki.js (requarks.io)

 

Git

Storage Module

docs.requarks.io

Git 설치

하는 수 없이 그냥 git을 설정해서 커밋, 푸쉬까지 하긴 했지. 그런데 문제는 이게 docker로 위키를 실행 중이라서 잘 모르겠다는거지. 나는 도커로 설치할 때 분명히 폴더를 지정해뒀는데, 도커 컨테이너는 어디서 실행 중인건지 잘 모르겠는거지. 컨테이너 경로는 알겠는데 그걸 어떻게 풀어가는지를 모르겠다는거지. 볼륨이라는 건 설정이 된거 같은디 볼륨 개념도 잘 모르겠고 뭐 도커 개념 자체가 그냥 어려움.

git 사용방법은 git 홈페이지에 book이 상세 설명되어있고 한글 번역도 되어있음. 근데 한국말인데도 어렵다.
Git - Book (git-scm.com)

 

Git - Book

 

git-scm.com

github에 나와있는 설명이 차라리 더 쉬운거 같긴한데, 설명은 git 홈페이지가 더 잘 나온 거 같은 느낌적인 느낌.
About Git - GitHub Docs

 

About Git - GitHub Docs

About version control and Git A version control system, or VCS, tracks the history of changes as people and teams collaborate on projects together. As developers make changes to the project, any earlier version of the project can be recovered at any time.

docs.github.com

SSH 관련 설정 방법은 github를 보고 따라함.
About SSH - GitHub Docs

 

About SSH - GitHub Docs

When you set up SSH, you will need to generate a new SSH key and add it to the ssh-agent. You must add the SSH key to your account on GitHub before you use the key to authenticate. For more information, see "Generating a new SSH key and adding it to the ss

docs.github.com

 

그런데 아무튼 결과적으로 git 연동에 실패함. 이유는 도커를 이해하지 못했기 때문으로 판단한다. 그래서 백업을 하지 못하는 상황이 되어버렸다. 이걸 우짜지? 그냥 현 시점에는 인스턴스 스냅샷에 의존하는 수밖에 없다.

도커 먼저 설명서 좀 봐야지 안되겄네.

교훈

이리저리 웹 서핑을 하면서 뭔가 안될 때마다 안되는 것만 가지고 해결방법을 찾아서 진행하는 방식은 글러 먹었다. 수많은 시간이 날아간듯. 그냥 어떤 소프트웨어를 사용할 때는 사용설명서를 보고 개념부터 이해하는 게 결과적으로 가장 빠른 길이라는 걸 알게 되었다. 이해하지 못한 상태에서는 아무 것도 대응할 수가 없다. 허허허