메인 컨텐츠로 이동

DocSearch 마이그레이션

· 6분 읽기 분량
클레망 바니카트(Clément Vannicatte)
세바스티앵 로버(Sébastien Lorber)

DocSearch는 사용자가 알골리아 애플리케이션과 새로운 자격증명을 사용할 수 있도록 새롭고 강력한 시스템으로 마이그레이션을 진행하고 있습니다.

도큐사우루스 사이트를 가지고 있다면 2022년 2월 1일까지 새로운 자격증명을 구성하고 업그레이드를 해야 합니다. 2월 1일 이후에는 기존 검색 색인은 더 이상 동작하지 않으며 읽기 전용이 됩니다.

도큐사우루스 사이트 업그레이드하기

앞으로 몇 주 안에 도큐사우루스 사이트 관리자는 알골리아 애플리케이션에 참여하도록 초대하는 이메일을 받게 될 겁니다.

이메일에는 도큐사우루스 구성에 필요한 새로운 appIdapiKey가 포함되어 있습니다.

여러분이 할 일은 아래와 같습니다.

  • 알골리아 애플리케이션 가입(새로운 알골리아 계정을 만들어야 합니다)
  • 여러분의 사이트 구성 업데이트
docusaurus.config.js
const config = {
themeConfig: {
algolia: {
appId: '<NEW_APP_ID>',
apiKey: '<NEW_SEARCH_API_KEY>',
},
},
};

module.exports = config;
info

appId필수항목입니다.

키 값은 비밀이 아니며 여러분의 깃 저장소에 추가할 수 있습니다.

DocSearch에게 새로운 집이 생겼어요!

DocSearch는 무엇인가요?

DocSearch알골리아에서 만든 무료 오픈 소스 프로젝트의 기술 문서 및 기술 블로그 검색 프로그램입니다.

좀 더 자세한 내용은 여기에서 확인할 수 있으며 궁금하다면 직접 체험해볼 수도 있습니다!

이번 마이그레이션은 어떤 것인가요?

동기

조만간 DocSearch UI의 정식 버전이 출시되면 사용자에게 더 나은 도구를 제공할 수 있으며 검색 경험을 향상시키고 알골리아의 잠재력을 활용할 수 있도록 합니다.

새로운 소식이 있나요?

DocSearch는 다음과 같은 기능을 웹 인터페이스로 제공해 알골리아 크롤러의 활용성을 향상시킵니다.

  • 크롤러를 시작하거나 일정을 관리하고 모니터링합니다.
  • 설정 파일을 실시간으로 편집할 수 있습니다.
  • DocSearch v3 결과를 테스트합니다.

Algolia crawler overview

Algolia config editor

알골리아 앱에서는 더 많은 알골리아 기능을 활용할 수 있습니다.

  • 팀 관리
  • 알골리아에서 데이터를 어떻게 인덱싱하는지 탐색하고 확인하기
  • 무료로 다른 알골리아 기능 체험하기

Algolia index overview

Algolia index analytics

그리고 더 많은 기능이 무료로 제공됩니다.

자주 묻는 질문(FAQ)

도큐사우루스와 DocSearch를 사용하고 있습니다. 마이그레이션이 필요한가요?

이 글을 쓰는 현재로서는 아직 마이그레이션 초기 단계입니다. 매주 소규모 배치 작업을 진행하고 있으며 조만간 규모를 키울 예정입니다. 조금만 기다려주세요. 알골리아 앱을 사용할 준비가 되면 여러분의 메일함에서 확인할 수 있을 겁니다.

자세한 내용은 어디에서 확인할 수 있나요?

간단한 마이그레이션 가이드를 작성했습니다. 좀 더 자세한 내용은 마이그레이션 안내 이메일을 통해 전달해드릴 겁니다.

마이그레이션 이메일을 받았지만 초대가 만료됐습니다.

이메일이나 DocSearch 디스코드 또는 도큐사우루스 디스코드 #algolia 채널로 연락주세요.

피드백은 어떻게 보낼 수 있나요?

문서나 DocSearch UI 컴포넌트에 대한 피드백은 깃허브 저장소에 이슈로 등록하거나 앞에서 설명한 연락처를 통해 전달할 수 있습니다.

나만의 DocSearch 인스턴스는 계속 실행할 수 있나요?

새로운 인프라와 DocSearch v3에 집중하게 되면서 더 이상 DocSearch 스크래퍼DocSearch v2에 대한 유지 보수는 제공하지 않습니다. 하지만 저장소는 계속 사용할 수 있고 풀리퀘스트를 요청할 수도 있습니다.

이전 문서(이제는 레가시가 된)와 run your own 가이드도 계속 사용할 수 있습니다.