본 문서는 아마존 클라우드 EC2 서버에 okd를 설치하는 과정을 설명한다.

1. EC2 서버 한대 준비

t3.micro 정도로도 가능하다. 그리고 Amazon Linux 면 된다. 서버를 만들고 접속한다. (노트북 같은 개인 PC로 해도 된다)

2. 키 생성

위 EC2 서버 접속 후 키를 만든다. 다음과 같이 하면 된다.

$ ssh-keygen -t ed25519 -N '' -f okd.key

그러면 key 파일과 pub 파일이 쌍으로 생성성된다.

3. 키 추가 작업

$ eval "$(ssh-agent -s)"
$ ssh-add okd.key

ssh-add 시에 기대되는 결과는 다음과 같다.

Identity added: /home/<you>/<path>/<file_name> (<computer_name>)

4. 설치파일 다운로드

https://github.com/openshift/okd/releases 에서 받을 수 있다. 나는 wget 으로 openshift-install-linux-4.13.0-0.okd-2023-08-18-135805.tar.gz 파일을 받았다.

그리고 압축을 푼다.

$ tar -xvf openshift-install-linux.tar.gz

5. 클러스터 생성

위에서 다운받고 압축 푼 파일을 이용하여 설치를 시작한다.

$ ./openshift-install create cluster --dir /home/ec2-user/okd --log-level=info

/home/ec2-user/okd는 설치하고자 하는 경로다. 각자 취향에 맞게 지정한다.

그리고 중간에 pull secret 넣으라고 나오는데 나는 그냥 {"auths":{"fake":{"auth":"aWQ6cGFzcwo="}}} 입력하여 넘어갔다.

이제 시간이 많이 걸린다. 상당히 큰 스펙을 가진 여러 EC2 서버가 계속 생성된다.

6. 커맨드 라인 유틸리티 설치

https://github.com/okd-project/okd/releases 에서 openshift-client-linux-4.13.0-0.okd-2023-08-18-135805.tar.gz 를 다운받는다. wget 으로 받아도 된다.

풀면 oc 와 kubectl 이 나온다. 적당히 PATH 걸린 곳에 넣어주면 된다. (/usr/bin 등)

7. KUBECONFIG 설정

$ export KUBECONFIG=/home/ec2-user/okd/auth/kubeconfig

아까 설치 지정한 위치 /home/ec2-user/okd 하위의 auth/kubeconfig 위치를 KUBECONFIG 환경변수로 지정한다.

이렇게 하면 커맨드 상에서 okd 쿠버네티스를 사용할 수 있다. kubectl get node, kubectl get pods 가능.