CI/CD 파이프라인을 "배포가 흐르는 사무실"로 표현해 보면 어떨까요? 빌드·테스트·배포·모니터링·롤백을 맡은 AI 담당자들이 각자 자리에 앉아 있고, 마우스로 돌려 보며 역할을 확인할 수 있는 three.js 3D 사무실을 만든 과정을 정리합니다. 외부 3D 모델 없이 박스·원기둥·구 같은 기본 도형과 canvas 텍스처만으로 만들었습니다.
0. 완성 모습과 구성
- 6개 업무석: 플랫폼 PL(총괄), 파이프라인(CI), 배포 자동화(CD), 품질 게이트, 관측(모니터링), 복구 검증(롤백)
- 회의 공간, 라운지, 커피바, 유리 외벽 등 사무실 인테리어
- 드래그 회전 · 휠 확대 · 담당자 클릭 시 역할 설명 · 시점 전환 · 석양/야간 조명 · PNG 저장
1. 준비: three.js를 importmap으로 불러오기
번들러 없이 HTML 한 장으로 시작합니다. three.js(r180 기준)와 애드온(OrbitControls, RoundedBoxGeometry, RoomEnvironment)을 importmap으로 연결합니다. 모듈은 file://로는 막히는 경우가 많으니 로컬 서버(npx serve 등)로 열어 주세요.
<script type="importmap">
{"imports":{
"three": "https://cdn.jsdelivr.net/npm/three@0.180.0/build/three.module.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/three@0.180.0/examples/jsm/"
}}
</script>
<div id="viewport"></div>
<script type="module">
import * as THREE from 'three';
import {OrbitControls} from 'three/addons/controls/OrbitControls.js';
import {RoundedBoxGeometry} from 'three/addons/geometries/RoundedBoxGeometry.js';
import {RoomEnvironment} from 'three/addons/environments/RoomEnvironment.js';
</script>
2. 장면·렌더러·카메라·컨트롤
사무실을 위에서 비스듬히 내려다보는 "아이소메트릭 느낌"의 원근 카메라를 쓰고, 부드러운 그림자와 톤매핑으로 분위기를 잡습니다.
const scene = new THREE.Scene();
scene.background = new THREE.Color('#e9e2da');
scene.fog = new THREE.Fog('#e9e2da', 48, 100);
const renderer = new THREE.WebGLRenderer({antialias:true, preserveDrawingBuffer:true});
renderer.setPixelRatio(Math.min(devicePixelRatio, 1.6));
renderer.setSize(innerWidth, innerHeight);
renderer.shadowMap.enabled = true;
renderer.shadowMap.type = THREE.PCFSoftShadowMap;
renderer.toneMapping = THREE.ACESFilmicToneMapping;
renderer.outputColorSpace = THREE.SRGBColorSpace;
document.getElementById('viewport').append(renderer.domElement);
const camera = new THREE.PerspectiveCamera(37, innerWidth/innerHeight, .1, 150);
camera.position.set(20, 18, 23);
const controls = new OrbitControls(camera, renderer.domElement);
controls.enableDamping = true;
controls.minDistance = 11; controls.maxDistance = 48;
controls.maxPolarAngle = Math.PI * .46; // 바닥 아래로 못 내려가게
preserveDrawingBuffer:true는 나중에 "이미지 저장" 버튼에서 캔버스를 PNG로 뽑기 위한 설정입니다.
3. 조명: 따뜻한 햇빛 + 환경광
세 가지를 섞습니다. 하늘/땅 반사광(HemisphereLight), 그림자를 만드는 해(DirectionalLight), 반대편 보조광, 그리고 RoomEnvironment로 만든 환경 맵(금속·유리 반사용).
const pmrem = new THREE.PMREMGenerator(renderer);
scene.environment = pmrem.fromScene(new RoomEnvironment(), .04).texture;
scene.environmentIntensity = .42;
scene.add(new THREE.HemisphereLight('#fff4d7', '#8e917e', 1.35));
const sun = new THREE.DirectionalLight('#ffd3a0', 3.3);
sun.position.set(-8, 15, -9);
sun.castShadow = true;
sun.shadow.mapSize.set(4096, 4096);
Object.assign(sun.shadow.camera, {left:-17, right:17, top:17, bottom:-17, near:1, far:50});
sun.shadow.normalBias = .035; // 그림자 줄무늬(acne) 방지
scene.add(sun);
4. 도형 헬퍼 함수 만들기
사무실 전체가 결국 박스와 원기둥의 조합이라서, 위치·재질을 한 줄로 쓰는 헬퍼를 먼저 만들면 편합니다. 모서리를 살짝 둥글린 RoundedBoxGeometry가 "완성도"의 큰 차이를 만듭니다. 같은 크기의 지오메트리는 캐시해서 재사용합니다.
const mats = {};
const mat = (name, color, roughness=.65, metalness=0) =>
mats[name] ||= new THREE.MeshStandardMaterial({color, roughness, metalness});
const geoCache = new Map();
function box(w,h,d, m, x=0,y=0,z=0, r=.035, parent=scene){
const key = [w,h,d,r].join(':');
if(!geoCache.has(key))
geoCache.set(key, r ? new RoundedBoxGeometry(w,h,d,2,Math.min(r,w/3,h/3,d/3))
: new THREE.BoxGeometry(w,h,d));
const mesh = new THREE.Mesh(geoCache.get(key), m);
mesh.position.set(x,y,z);
mesh.castShadow = mesh.receiveShadow = true;
parent.add(mesh);
return mesh;
}
// cyl(), ball(), group() 도 같은 방식으로 만듭니다.
5. 바닥·벽·유리 외벽
바닥은 나무 판자를 한 장씩 깔고, 벽은 "단면도"처럼 낮게 잘라 사무실 안이 한눈에 보이게 했습니다. 뒤쪽과 왼쪽에는 황동 프레임과 반투명 MeshPhysicalMaterial 유리를 둡니다.
const glass = new THREE.MeshPhysicalMaterial({
color:'#c4d7d0', transparent:true, opacity:.12,
roughness:.08, side:THREE.DoubleSide, depthWrite:false // 반투명 겹침 깜빡임 방지
});
box(20, 3.8, .025, glass, 0, 2.5, -7, 0); // 유리면
for (let x=-9.9; x<=10; x+=2.5) box(.065, 4.1, .08, brass, x, 2.4, -7, .008); // 프레임 기둥
6. canvas로 텍스처 만들기 (이미지 파일 없이)
나무 결, 간판 글씨, 모니터 화면을 모두 2D canvas로 그려 텍스처로 씁니다. 모니터에는 "Pipeline / Stages", "workspace / deploy.yml" 같은 그럴듯한 화면을 그려 CI/CD 분위기를 냅니다.
function canvasTexture(w, h, draw){
const c = document.createElement('canvas'); c.width = w; c.height = h;
draw(c.getContext('2d'), w, h);
const t = new THREE.CanvasTexture(c);
t.colorSpace = THREE.SRGBColorSpace;
t.anisotropy = renderer.capabilities.getMaxAnisotropy();
return t;
}
const signTex = canvasTexture(1024, 256, (c,w,h) => {
c.fillStyle = '#374f41'; c.textAlign = 'center';
c.font = '500 86px Georgia'; c.fillText('Platform Atelier', w/2, 123);
c.font = '24px sans-serif'; c.fillText('CI / CD / PLATFORM 3F', w/2, 188);
});
const sign = new THREE.Mesh(new THREE.PlaneGeometry(4.6,1.15),
new THREE.MeshBasicMaterial({map:signTex, transparent:true, depthWrite:false}));
sign.position.set(-6.5, 2.65, -6.9); scene.add(sign);
화면처럼 스스로 밝아 보여야 하는 면은 조명 영향을 받지 않는 MeshBasicMaterial을 씁니다.
7. 업무석과 로봇 담당자
책상 하나는 상판 + 다리 + 모니터 + 키보드 + 화분 + 의자로 조립하는 함수 desk()입니다. 담당자는 흰 구체 머리, 검은 얼굴 패널, 빛나는 눈, 역할별 포인트 색(accent)으로 만든 둥근 로봇입니다. 역할마다 소품이 조금씩 다릅니다(안전모는 품질 게이트, 헤드셋은 PL 등).
const team = [
['플랫폼 AI PL', '총괄', '빌드·배포·운영 작업을 조율하고 현황과 승인 요청을 보고합니다.', '#426b55'],
['파이프라인', 'CI 파이프라인', '소스·빌드·테스트 단계를 잇는 파이프라인을 설계합니다.', '#a98a45'],
['배포 자동화', 'CD · 배포', '환경별 배포 절차와 자동화를 준비합니다.', '#837298'],
['품질 게이트', '품질·보안 게이트','승인과 품질·보안 검사 기준을 적용합니다.', '#b57b49'],
['관측', '모니터링', '로그·지표·알림 체계를 구성하고 상태를 확인합니다.', '#5b8d98'],
['복구 검증', '롤백·복구', '배포 실패 시 롤백과 복구 절차를 검증합니다.', '#9b7582'],
];
function robot(g, info, index){
const body = new THREE.Group(); g.add(body);
const accent = mat('accent'+index, info[3], .35, .2);
const white = mat('white', '#f4f3e9', .24, .12), black = mat('black', '#111d24', .19, .28);
ball(.29, white, 0, .39, 0, body, 1, 1.18, .78); // 몸통
const head = new THREE.Group(); head.position.set(0, .96, 0); body.add(head);
ball(.33, white, 0, 0, 0, head, 1.12, 1, .9); // 머리
box(.49, .29, .055, black, 0, .005, .277, .12, head); // 얼굴 패널
const eye = new THREE.MeshStandardMaterial({color:'#7fe5fa', emissive:'#42b9df', emissiveIntensity:2});
for (const s of [-1,1]) ball(.038, eye, s*.108, .015, .312, head, .65, 1.4, .45);
// ... 팔·다리는 어깨/팔꿈치/엉덩이/무릎 관절 그룹으로 만들어 자세를 바꿀 수 있게
body.traverse(o => { if (o.isMesh) o.userData.info = info; }); // 클릭 대상 표시
}
팔다리를 관절별 Group으로 나눠 두면 회전값만 바꿔서 "앉은 자세 ↔ 서서 걷는 자세"를 섞을 수 있습니다. 시연 모드에서 담당자들이 일어나 걸어가는 장면이 이 구조로 가능합니다.
8. 담당자 클릭: Raycaster
마우스 위치에서 레이를 쏴 로봇 메시를 맞추고, 오른쪽 상세 패널에 역할을 보여 줍니다. 드래그(회전)와 클릭을 구분하려고 포인터가 5px 이상 움직였으면 클릭으로 치지 않습니다.
const raycaster = new THREE.Raycaster(), pointer = new THREE.Vector2();
let down = null;
renderer.domElement.addEventListener('pointerdown', e => down = [e.clientX, e.clientY]);
renderer.domElement.addEventListener('pointerup', e => {
if (!down || Math.hypot(e.clientX-down[0], e.clientY-down[1]) > 5) return;
pointer.set(e.clientX/innerWidth*2-1, -e.clientY/innerHeight*2+1);
raycaster.setFromCamera(pointer, camera);
const hit = raycaster.intersectObjects(pickable, false)[0];
if (hit) selectInfo(hit.object.userData.info);
});
9. 머리 위 이름표: 3D 좌표 → 화면 좌표
이름표는 3D 객체가 아니라 HTML 버튼입니다. 매 프레임 로봇의 월드 좌표를 project(camera)로 화면 좌표로 바꿔 left/top에 넣습니다. 글씨가 항상 선명하고 접근성(키보드 포커스)도 좋아집니다.
const p = new THREE.Vector3();
function updateLabels(){
labels.forEach(l => {
l.object.getWorldPosition(p); p.y += l.offset; p.project(camera);
l.el.style.left = (p.x*.5+.5)*innerWidth + 'px';
l.el.style.top = (-p.y*.5+.5)*innerHeight + 'px';
l.el.hidden = p.z > 1 || Math.abs(p.x) > 1 || Math.abs(p.y) > 1; // 화면 밖/뒤쪽이면 숨김
});
}
10. 시점 전환, 석양/야간, 이미지 저장
"회의 공간/업무 공간/라운지" 버튼은 카메라 위치와 컨트롤 타깃을 1.1초 동안 부드럽게 보간(smoothstep)해서 이동합니다. 야간 모드는 해 밝기를 낮추고 천장 등(PointLight)을 올립니다.
const views = {
overview: {pos:[20,18,23], target:[0,.4,0]},
meeting: {pos:[8,10,14], target:[-3,1,0]},
desks: {pos:[16,11,10], target:[4,1,-2]},
lounge: {pos:[6,8,16], target:[-5,.8,4]},
};
let travel = null;
function view(name){
const v = views[name];
travel = {from:camera.position.clone(), to:new THREE.Vector3(...v.pos),
start:controls.target.clone(), end:new THREE.Vector3(...v.target),
time:performance.now()};
}
function frame(now){
if (travel){
const t = Math.min(1, (now - travel.time) / 1100), k = t*t*(3-2*t);
camera.position.lerpVectors(travel.from, travel.to, k);
controls.target.lerpVectors(travel.start, travel.end, k);
if (t === 1) travel = null;
}
controls.update();
updateLabels();
renderer.render(scene, camera);
}
renderer.setAnimationLoop(frame);
// PNG 저장
function capture(){
renderer.render(scene, camera);
const a = document.createElement('a');
a.download = 'Platform-Atelier-3D.png';
a.href = renderer.domElement.toDataURL('image/png');
a.click();
}
11. 시연 모드: "일이 넘어가는 흐름" 연출
PL이 "빌드 시작" → 파이프라인이 "테스트 통과" → 배포 자동화 → 품질 게이트 승인 → 관측 → 복구 검증 순으로 말풍선을 주고받습니다. 말풍선도 HTML이고, 말하는 담당자 위치로 카메라와 표시 고리(RingGeometry)가 이동합니다. 사람(Human Architect)이 목표를 주고 마지막에 승인하는 흐름을 넣어서, "AI가 일하되 판단과 승인은 사람"이라는 CI/CD의 승인 게이트를 그대로 형상화했습니다. 화면의 문구는 모두 예시이며 실제 파이프라인과 연결된 것은 아닙니다.
12. 만들면서 얻은 팁
- 성능: 지오메트리 캐시,
setPixelRatio 상한(1.6), 이름표 갱신은 약 30ms 간격으로 제한.
- 그림자: 그림자 카메라 범위를 사무실 크기에 딱 맞추고
normalBias를 조금 주면 깔끔합니다.
- 유리: 투명 재질은
depthWrite:false가 필수, 그렇지 않으면 뒤 물체가 가려집니다.
- 모션 감소:
prefers-reduced-motion 사용자를 위해 CSS 애니메이션을 끄는 옵션을 둡니다.
- 실패 대비: WebGL 초기화는
try/catch로 감싸고 안내 문구를 보여 주세요.
- 다음 단계: 지금은 시연용이지만, 실제 CI 서버(GitHub Actions, Jenkins 등)의 웹훅/SSE 이벤트를 받아 로봇의 상태(대기·작업 중·실패)를 바꾸면 "살아 있는" 대시보드가 됩니다.
마무리
복잡한 3D 모델링 도구 없이도 기본 도형, canvas 텍스처, 조명만으로 충분히 분위기 있는 공간을 만들 수 있습니다. CI/CD처럼 눈에 보이지 않는 흐름을 공간과 캐릭터로 바꾸면 팀 안에서 설명하기도 훨씬 쉬워집니다. 궁금한 점은 댓글로 남겨 주세요.