절차

1. 플랫폼용 Red Hat OpenShift Local 최신 릴리스를 다운로드합니다.
2. Microsoft Windows에서 아카이브의 내용을 추출합니다.

3. macOS 또는 Microsoft Windows에서 안내된 설치 관리자를 실행하고 지침을 따릅니다.

   참고

   Microsoft Windows에서는 로컬 C:\ 드라이브에 Red Hat OpenShift Local을 설치해야 합니다. 네트워크 드라이브에서 Red Hat OpenShift Local을 실행할 수 없습니다.

   Red Hat Enterprise Linux에서 아카이브가 ~/Downloads 디렉터리에 있다고 가정하면 다음 단계를 따르십시오.

   1. 아카이브의 내용을 추출합니다.

      $ cd ~/Downloads
      $ tar xvf crc-linux-amd64.tar.xz

   2. ~/bin 디렉터리가 없는 경우 생성하고 crc 실행 파일을 복사합니다.

      $ mkdir -p ~/bin
      $ cp ~/Downloads/crc-linux-*-amd64/crc ~/bin

   3. $PATH 에 ~/bin 디렉토리를 추가합니다.

      $ export PATH=$PATH:$HOME/bin
      $ echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc

절차

1. Red Hat OpenShift Local의 최신 릴리스를 다운로드합니다.

2. 기존 Red Hat OpenShift Local 인스턴스를 삭제합니다.

   $ crc delete

   주의

   crc delete 명령을 실행하면 Red Hat OpenShift Local 인스턴스에 저장된 데이터가 손실됩니다. 이 명령을 실행하기 전에 인스턴스에 저장된 원하는 정보를 저장합니다.

3. 이전 crc 실행 파일을 최신 릴리스의 실행 파일로 교체합니다. 버전을 확인하여 새 crc 실행 파일이 사용 중인지 확인합니다.

   $ crc version

4. 새로운 Red Hat OpenShift Local 릴리스를 설정합니다.

   $ crc setup

5. 새 Red Hat OpenShift Local 인스턴스를 시작합니다.

   $ crc start

절차

1. (선택 사항) Linux에서 OpenShift Container Platform 사전 설정은 기본적으로 선택됩니다. Podman 컨테이너 런타임 사전 설정을 선택하려면 다음을 수행합니다.

   $ crc config set preset podman

2. Red Hat OpenShift Local의 호스트 시스템을 설정합니다.

   $ crc setup

절차

1. Red Hat OpenShift Local 인스턴스를 시작합니다.

   $ crc start

2. OpenShift 사전 설정의 경우 메시지가 표시되면 사용자 풀 시크릿을 제공합니다.

   참고

   요청을 처리하기 전에 클러스터가 필요한 컨테이너 및 Operator를 시작하는 데 최소 4분이 걸립니다.

절차

1. Red Hat OpenShift Local에서 관리하는 실행 중인 OpenShift Container Platform 클러스터에 developer 사용자로 로그인합니다.

   $ odo login -u developer -p developer

2. 애플리케이션에 사용할 프로젝트를 생성합니다.

   $ odo create project sample-app

3. 구성 요소 디렉터리를 생성합니다.

   $ mkdir sample-app
   $ cd sample-app

4. Node.js 애플리케이션 예를 초기화합니다.

   $ odo init --name sample-app --devfile nodejs --starter nodejs-starter

5. nodejs 애플리케이션을 개발합니다.

   $ odo dev

6. 브라우저에서 애플리케이션에 액세스하려면 odo dev 명령 출력에서 URL을 사용합니다.

절차

1. http_proxy 및 https_proxy 환경 변수를 사용하거나 crc config set 명령을 사용하여 다음과 같이 프록시를 정의합니다.

   $ crc config set http-proxy http://proxy.example.com:<port>
   $ crc config set https-proxy http://proxy.example.com:<port>
   $ crc config set no-proxy <comma-separated-no-proxy-entries>

2. 프록시에서 사용자 정의 CA 인증서 파일을 사용하는 경우 다음과 같이 설정합니다.

   $ crc config set proxy-ca-file <path-to-custom-ca-file>

절차

1. 클러스터를 시작합니다.

   $ crc start

   이 프로세스 중에 클러스터가 계속 실행되고 있는지 확인합니다.

2. haproxy 패키지 및 기타 유틸리티를 설치합니다.

   $ sudo dnf install haproxy /usr/sbin/semanage

3. 클러스터와의 통신을 허용하도록 방화벽을 수정합니다.

   $ sudo systemctl enable --now firewalld
   $ sudo firewall-cmd --add-service=http --permanent
   $ sudo firewall-cmd --add-service=https --permanent
   $ sudo firewall-cmd --add-service=kube-apiserver --permanent
   $ sudo firewall-cmd --reload

4. SELinux의 경우 HAProxy가 이 포트에서 kube-apiserver 를 제공하도록 TCP 포트 6443에서 수신 대기하도록 허용합니다.

   $ sudo semanage port -a -t http_port_t -p tcp 6443

5. 기본 haproxy 구성의 백업을 생성합니다.

   $ sudo cp /etc/haproxy/haproxy.cfg{,.bak}

6. 클러스터와 함께 사용할 haproxy 를 구성합니다.

   $ export CRC_IP=$(crc ip)
   $ sudo tee /etc/haproxy/haproxy.cfg &>/dev/null <<EOF
   global
       log /dev/log local0
   
   defaults
       balance roundrobin
       log global
       maxconn 100
       mode tcp
       timeout connect 5s
       timeout client 500s
       timeout server 500s
   
   listen apps
       bind 0.0.0.0:80
       server crcvm $CRC_IP:80 check
   
   listen apps_ssl
       bind 0.0.0.0:443
       server crcvm $CRC_IP:443 check
   
   listen api
       bind 0.0.0.0:6443
       server crcvm $CRC_IP:6443 check
   EOF

7. haproxy 서비스를 시작합니다.

   $ sudo systemctl start haproxy

절차

1. dnsmasq 패키지를 설치합니다.

   $ sudo dnf install dnsmasq

2. NetworkManager에서 DNS 확인을 위해 dnsmasq 사용을 활성화합니다.

   $ sudo tee /etc/NetworkManager/conf.d/use-dnsmasq.conf &>/dev/null <<EOF
   [main]
   dns=dnsmasq
   EOF

3. Red Hat OpenShift Local의 DNS 항목을 dnsmasq 구성에 추가합니다.

   $ sudo tee /etc/NetworkManager/dnsmasq.d/external-crc.conf &>/dev/null <<EOF
   address=/apps-crc.testing/SERVER_IP_ADDRESS
   address=/api.crc.testing/SERVER_IP_ADDRESS
   EOF

   참고

   /etc/NetworkManager/dnsmasq.d/crc.conf 의 기존 항목을 주석 처리합니다. 이러한 항목은 Red Hat OpenShift Local의 로컬 인스턴스를 실행하여 생성되며 원격 클러스터의 항목과 충돌합니다.

4. NetworkManager 서비스를 다시 로드합니다.

   $ sudo systemctl reload NetworkManager

5. oc:를 사용하여 developer 사용자로 원격 클러스터에 로그인합니다.

   $ oc login -u developer -p developer https://api.crc.testing:6443

   원격 OpenShift Container Platform 웹 콘솔은 https://console-openshift-console.apps-crc.testing에서 확인할 수 있습니다.

절차

1. enable-cluster-monitoring 구성 가능 속성을 true 로 설정합니다.

   $ crc config set enable-cluster-monitoring true

2. 인스턴스를 시작합니다.

   $ crc start

   주의

   클러스터 모니터링을 비활성화할 수 없습니다. 모니터링을 제거하려면 enable-cluster-monitoring 구성 가능 속성을 false 로 설정하고 기존 Red Hat OpenShift Local 인스턴스를 삭제합니다.

절차

1. oc get nodes 명령을 실행하여 원하는 노드를 확인합니다. 출력은 다음과 유사합니다.

   $ oc get nodes
   NAME                 STATUS   ROLES           AGE    VERSION
   crc-shdl4-master-0   Ready    master,worker   7d7h   v1.14.6+7e13ab9a7

2. oc debug nodes/ <node >를 실행합니다. 여기서 <node>는 이전 단계에서 인쇄된 노드의 이름입니다.

1. 최신 Red Hat OpenShift Local 릴리스를 다운로드하여 $PATH 에 crc 실행 파일을 배치합니다.

2. crc delete 명령을 사용하여 인증서 오류가 있는 클러스터를 제거합니다.

   $ crc delete

   주의

   crc delete 명령을 실행하면 Red Hat OpenShift Local 인스턴스에 저장된 데이터가 손실됩니다. 이 명령을 실행하기 전에 인스턴스에 저장된 원하는 정보를 저장합니다.

3. 새 릴리스를 설정합니다.

   $ crc setup

4. 새 인스턴스를 시작합니다.

   $ crc start

절차

1. 인스턴스를 시작하기 전에 crc delete 명령을 실행합니다.

   $ crc delete

   주의

   crc delete 명령을 실행하면 Red Hat OpenShift Local 인스턴스에 저장된 데이터가 손실됩니다. 이 명령을 실행하기 전에 인스턴스에 저장된 원하는 정보를 저장합니다.

1. Red Hat OpenShift Local 인스턴스를 중지합니다.

   $ crc stop

2. Red Hat OpenShift Local 인스턴스를 삭제합니다.

   $ crc delete

   주의

   crc delete 명령을 실행하면 Red Hat OpenShift Local 인스턴스에 저장된 데이터가 손실됩니다. 이 명령을 실행하기 전에 인스턴스에 저장된 원하는 정보를 저장합니다.

3. crc setup 명령에서 나머지 변경 사항을 정리합니다.

   $ crc cleanup

   참고

   crc cleanup 명령은 기존 Red Hat OpenShift Local 인스턴스를 제거하고 crc setup 명령으로 생성된 DNS 항목으로 변경 사항을 되돌립니다. macOS에서 crc cleanup 명령도 시스템을 제거합니다.

4. 변경 사항을 다시 적용하도록 호스트 시스템을 설정합니다.

   $ crc setup

5. Red Hat OpenShift Local 인스턴스를 시작합니다.

   $ crc start

   참고

   요청을 처리하기 전에 클러스터가 필요한 컨테이너 및 Operator를 시작하는 데 최소 4분이 걸립니다.

1. 발생하는 문제에 대해 열려 있는 문제를 검색합니다.
2. 발생한 문제를 해결한 기존 문제가 없는 경우 문제를 생성하고 ~/.crc/crc.log 파일을 생성된 문제에 연결합니다. ~/.crc/crc.log 파일에는 자세한 디버깅 및 문제 해결 정보가 있어 현재 발생하는 문제를 진단하는 데 도움이 됩니다.