디바이스 연결

IronFlock은 하드웨어와 운영 체제에 따라 다양한 디바이스 연결 방법을 지원합니다. 아직 하드웨어가 없나요? 몇 분 만에 노트북에서 디바이스를 시뮬레이션해 볼 수 있습니다.

사전 요구사항

디바이스를 연결하기 전에 다음 사항을 준비하십시오:

IronFlock에서 생성된 프로젝트
해당 프로젝트 내에 생성된 디바이스 항목(프로젝트 설정 → 디바이스 패널에서 새 디바이스 클릭)
다운로드된 디바이스 구성 파일(.flock)

먼저 테스트하기: 노트북에서 디바이스 시뮬레이션

IronFlock을 살펴보는 데 물리적 하드웨어가 꼭 필요한 것은 아닙니다. FlockFlasher 앱은 IronFlock 에이전트를 노트북에서 직접 실행할 수 있으므로, 노트북이 프로젝트 내에서 실제 디바이스처럼 동작합니다 — 실제 하드웨어에 배포하기 전에 앱과 대시보드를 테스트하기에 안성맞춤입니다.

Docker Desktop(Linux에서는 Docker Engine)을 설치하고 실행 중인지 확인합니다.
사용 중인 OS에 맞는 FlockFlasher 앱을 다운로드하여 설치합니다.
다운로드한 디바이스의 .flock 파일을 더블 클릭합니다 — 파일이 FlockFlasher에서 열리고 디바이스가 목록에 표시됩니다. (또는 FlockFlasher를 열고 + 버튼으로 파일을 추가할 수도 있습니다.)
디바이스 항목에서 Test Device(▶, 디바이스 테스트) 버튼을 클릭합니다. FlockFlasher가 처음 사용할 때 IronFlock 에이전트를 자동으로 다운로드하고 디바이스 구성으로 시작합니다.

이제 노트북이 IronFlock 프로젝트 내에서 이 디바이스 역할을 합니다. 온라인 상태로 표시되며, 실제 디바이스와 똑같이 앱을 설치하고 실행할 수 있습니다. 앱은 노트북에서 Docker 컨테이너로 실행됩니다.

테스트가 끝나면 FlockFlasher에서 테스트를 중지하십시오. 나중에 동일한 .flock 파일을 사용하여 실제 디바이스를 프로비저닝할 수 있습니다 — 단, 하나의 디바이스 구성은 한 번에 한 대의 머신에서만 실행해야 합니다.

방법 1: SD 카드 플래싱

SD 카드에서 부팅하는 Raspberry Pi 및 기타 ARM 디바이스에 적합합니다.

사용 중인 OS에 맞는 FlockFlasher 앱을 다운로드합니다.
SD 카드(최소 16GB)를 컴퓨터에 삽입합니다.
FlockFlasher를 열고 + 버튼을 클릭하여 .flock 파일을 불러옵니다.
SD 카드 드라이브를 선택합니다(FlockFlasher가 외부 드라이브를 자동으로 감지합니다).
디바이스에 맞는 이미지를 선택합니다(Raspberry Pi 3/4, Zero 등).
선택적으로 WiFi를 구성하여 디바이스가 목적지에서 연결할 수 있도록 합니다.
Flash를 클릭하고 쓰기, 검증, 구성이 완료될 때까지 기다립니다.
SD 카드를 디바이스에 삽입하고 전원을 켭니다.

디바이스는 20분 내에 온라인 상태가 되어야 합니다.

경고: 플래싱 과정은 선택한 드라이브의 모든 데이터를 삭제합니다. FlockFlasher는 기본적으로 내부 드라이브를 숨기지만, 플래싱 전에 항상 선택한 드라이브를 다시 확인하십시오.

방법 2: 산업용 PC를 위한 USB 설치

EFI 부팅을 지원하는 AMD64 디바이스(예: Siemens SIMATIC Box IPC)에 적합합니다.

USB 스틱(최소 16GB)을 삽입하고 FlockFlasher를 엽니다.
.flock 파일을 불러오고 USB 드라이브를 선택합니다.
Industrial PC x86_64 (EFI) 이미지를 선택합니다.
Flash를 클릭하고 완료될 때까지 기다립니다.
필요한 경우 디바이스의 BIOS에서 부팅 순서를 변경하여 USB에서 부팅하도록 설정합니다.
USB 스틱을 삽입하고 디바이스의 전원을 켭니다.

디바이스는 60분 내에 온라인 상태가 되어야 합니다.

방법 3: 커스텀 설치

기존 Linux OS를 유지하는 디바이스에 적합합니다. NVIDIA Jetson 및 커스텀 하드웨어에 이상적입니다.

참고: 이 수동 설치 방법은 산업용 PC, 게이트웨이, 임베디드 디바이스와 같은 실제 프로덕션 하드웨어를 위한 것이며, 노트북용이 아닙니다. 노트북에서 IronFlock을 간단히 사용해 보고 싶다면 대신 먼저 테스트하기: 노트북에서 디바이스 시뮬레이션을 따르십시오 — 수동 에이전트 설치가 필요하지 않습니다.

Linux / Unix 디바이스

디바이스에 SSH로 접속합니다.

설치 바이너리를 다운로드합니다:


curl -sSL https://instance-registry.ironflock.com/dl/reswarmify/install.sh | bash

컴퓨터에서 디바이스로 .flock 파일을 복사합니다:
```
scp mydevice.flock user@device-ip:/home/user/
```
에이전트를 실행합니다:
```
sudo ./ironflock-init -c mydevice.flock
```

회사 프록시 환경에 있나요? 다운로드가 성공하도록 2단계 전에 프록시를 export하고, 4단계에서 ironflock-init에 --http-proxy / --https-proxy를 전달하면 Docker 엔진을 자동으로 구성해 줍니다. 전체 명령과 회사 CA 단계는 회사 프록시 환경 사용을 참조하십시오.

Windows 장치

장치에 Docker Desktop 를 설치하고 Docker Desktop 설정에서 Start Docker Desktop when you sign in 을 활성화하세요. 무인 장치의 경우 재부팅 후 로그인 없이도 Docker를 사용할 수 있도록 Windows 자동 로그인도 설정하세요.
reagent.exe 를 다운로드하세요.
.flock 파일을 장치에 복사하세요.
관리자 권한 명령 프롬프트에서 에이전트를 Windows 서비스로 설치하고 시작하세요:
```
reagent.exe service install -config path\to\config.flock
```
서비스는 즉시 시작되며 이후 부팅할 때마다 시작되고, 오류 발생 시 자동으로 재시작되며 에이전트를 최신 상태로 유지합니다. 시작하지 않고 설치하려면 -noStart 를 추가하세요. 상태는 언제든지 reagent.exe service status 로 확인할 수 있습니다.

회사 프록시 환경인가요? service install 명령에 -proxy http://proxy.example.com:3128 를 추가하고, Docker Desktop의 프록시는 Settings → Resources → Proxies 에서 설정하세요. 자세한 내용과 회사 CA 설정 단계는 회사 프록시 환경 사용 을 참조하세요.

연결 확인

연결 후 프로젝트에서 디바이스 상태를 확인합니다:

녹색 표시기 — 디바이스가 온라인 상태이며 IronFlock과 통신 중입니다.
빨간색 표시기 — 디바이스가 오프라인 상태입니다. 네트워크 연결을 확인하고 에이전트가 실행 중인지 확인하십시오.

디바이스 지도 보기에서 프로젝트의 모든 디바이스의 지리적 위치를 확인할 수 있습니다.