중요 업그레이드 노트

Mattermost 버전 업그레이드 시 확인해야 할 중요 노트와 주의사항을 설명합니다.

Mattermost Server v10.11 확장 지원 릴리즈 지원이 2026년 8월 15일로 수명 주기가 종료될 예정입니다. Mattermost Server v11.7 이상 으로 업그레이드하는 것이 권장됩니다. 이 페이지 하단의 추가 업그레이드 노트 를 검토하는 것을 권장합니다. If you're upgrading from a version earlier than... Then... v11.8 커스텀 프로필 속성(Custom Profile Attributes) 속성 그룹의 이름이 custom_profile_attributes 에서 access_control 로 변경되며, CPA 필드와 값은 레거시 속성 모델에서 v2 모델로 마이그레이션됩니다. CPA 기능 자체의 동작은 변경되지 않습니다. CPA를 사용하는 플러그인 개발자는 새 그룹 이름으로 다시 등록해야 합니다. | | PSAv1(레거시) 그룹과 PSAv2 그룹을 구분하기 위해 PropertyGroups 테이블에 새로운 Version 컬럼이 추가되었습니다. 기존 그룹은 버전 1을 기본값으로 사용하여 모든 레거시 호출자에 대한 현재 동작을 그대로 유지합니다. PropertyGroups 는 설정 정보에 가까운 작은 테이블이며, ADD COLUMN ... DEFAULT 1 NOT NULL 은 PostgreSQL에서 메타데이터 전용 작업입니다 — 테이블 재작성이 발생하지 않으며 PropertyGroups 에 대한 AccessExclusiveLock 은 밀리초 단위로만 유지됩니다. 마이그레이션은 완전히 하위 호환되며 이 업그레이드에서 데이터베이스 다운타임은 예상되지 않습니다. 포함된 SQL 쿼리는: | | | | | | -- Pre-upgrade schema changes (Mattermost 11.8). | | | ALTER TABLE PropertyGroups ADD COLUMN IF NOT EXISTS Version integer DEFAULT 1 NOT NULL; | | | <code>posts.rootid</code>와 <code>posts.channelid</code>에 대한 PostgreSQL 플래너 통계 목표치를 기본값 100에서 5000으로 높이고, <code>ANALYZE posts (rootid, channelid)</code>로 플래너 통계를 새로 고칩니다. <code>ALTER COLUMN ... SET STATISTICS</code> 문은 메타데이터 전용 작업으로 <code>SHARE UPDATE EXCLUSIVE</code> 잠금만 획득합니다 — 테이블 재작성이 발생하지 않으며 <code>posts</code>에 대한 동시 SELECT, INSERT, UPDATE, DELETE는 차단되지 않습니다. <code>ANALYZE</code> 단계는 더 큰 샘플 크기로 인해 대규모 <code>posts</cod