asdf/assets/ko-kr_manage_configuration.md.DziiMa6H.js

import{_ as s,c as n,a2 as a,j as e,a as l,G as o,B as i,o as r}from"./chunks/framework.BQmytedh.js";const O=JSON.parse('{"title":"설정","description":"","frontmatter":{},"headers":[],"relativePath":"ko-kr/manage/configuration.md","filePath":"ko-kr/manage/configuration.md","lastUpdated":1734384735000}'),c={name:"ko-kr/manage/configuration.md"},p={tabindex:"0"},f={style:{"text-align":"left"}},u={tabindex:"0"},g={style:{"text-align":"left"}},h={tabindex:"0"},y={style:{"text-align":"left"}},b={tabindex:"0"},m={style:{"text-align":"left"}},x={tabindex:"0"},_={style:{"text-align":"left"}};function v(k,t,D,A,E,F){const d=i("Badge");return r(),n("div",null,[t[32]||(t[32]=a(`<h1 id="설정" tabindex="-1">설정 <a class="header-anchor" href="#설정" aria-label="Permalink to &quot;설정&quot;">​</a></h1><p><code>asdf</code>의 설정은 공유가능한 <code>.tool-versions</code> 파일들 뿐만 아니라 <code>.asdfrc</code>를 통한 특정한 사용자 맞춤화 및 환경 변수들을 모두 포함합니다.</p><h2 id="tool-versions" tabindex="-1"><code>.tool-versions</code> <a class="header-anchor" href="#tool-versions" aria-label="Permalink to &quot;\`.tool-versions\`&quot;">​</a></h2><p>한 디렉토리에 <code>.tool-versions</code> 파일이 존재하면, 해당 파일에 정의된 툴 버전들은 해당 디렉토리와 모든 하위 디렉토리에서 사용됩니다.</p><div class="warning custom-block"><p class="custom-block-title">노트</p><p>글로벌 기본값들은 <code>$HOME/.tool-versions</code> 파일에 설정 가능합니다</p></div><p><code>.tool-versions</code> 파일의 형태는 다음과 같습니다:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>ruby 2.5.3</span></span>
<span class="line"><span>nodejs 10.15.0</span></span></code></pre></div><p>다음과 같이 주석을 넣을 수 있습니다:</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>ruby 2.5.3 # This is a comment</span></span>
<span class="line"><span># This is another comment</span></span>
<span class="line"><span>nodejs 10.15.0</span></span></code></pre></div><p>버전들은 다음과 같은 형식일 수 있습니다:</p><ul><li><code>10.15.0</code> - 실제 버전. 바이너리 다운로드를 지원하는 플러그인은 바이너리를 다운로드합니다.</li><li><code>ref:v1.0.2-a</code> 혹은 <code>ref:39cb398vb39</code> - 지정된 태그/커밋/브랜치 Github로부터 다운로드하고 컴파일됩니다.</li><li><code>path:~/src/elixir</code> - 사용하려는 툴의 맞춤 컴파일 버전을 위한 경로. 언어 개발자들 등이 사용합니다.</li><li><code>system</code> - 이 키워드는 asdf가 asdf에 의해 관리되지 않는 시스템 버전 툴의 버전을 사용하게합니다.</li></ul><div class="tip custom-block"><p class="custom-block-title">TIP</p><p>다양한 버전들은 공백으로 구분하여 설정될 수 있습니다. 예를 들어, 파이썬 <code>3.7.2</code>를 사용하고, 파이썬 <code>2.7.15</code>로 그리고 마지막으로 <code>system</code> 파이썬으로 폴백하려면, 다음을 <code>.tool-versions</code>에 추가해주세요.</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>python 3.7.2 2.7.15 system</span></span></code></pre></div></div><p><code>.tool-version</code> 파일에 정의된 모든 툴들을 설치하려면 <code>.tool-version</code> 파일이 포함된 디렉토리에서 다른 인수 없이 <code>asdf install</code>을 실행합니다.</p><p><code>.tool-versions</code> 파일에 정의된 하나의 툴을 설치하려면 <code>.tool-version</code> 파일이 포함된 디렉토리에서 <code>asdf install &lt;name&gt;</code>를 실행합니다. 이 툴은 <code>.tool-versions</code> 파일에 정의된 버전으로 설치됩니다.</p><p>해당 파일은 직접 편집하거나 <code>asdf local</code> 명령어(또는 <code>asdf global</code> 명령어)를 사용하여 업데이트해 주세요.</p><h2 id="asdfrc" tabindex="-1"><code>.asdfrc</code> <a class="header-anchor" href="#asdfrc" aria-label="Permalink to &quot;\`.asdfrc\`&quot;">​</a></h2><p><code>.asdfrc</code> 파일은 사용자의 머신별 설정을 정의합니다.</p><p><code>\${HOME}/.asdfrc</code>는 asdf가 사용하는 기본 위치입니다. 이는 <a href="#asdfconfigfile">환경 변수 <code>ASDF_CONFIG_FILE</code></a>로 설정 가능합니다.</p><p>아래 파일은 필수적인 형식과 기본값들을 보여줍니다:</p><div class="language-txt vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">txt</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>legacy_version_file = no</span></span>
<span class="line"><span>use_release_candidates = no</span></span>
<span class="line"><span>always_keep_download = no</span></span>
<span class="line"><span>plugin_repository_last_check_duration = 60</span></span>
<span class="line"><span>disable_plugin_short_name_repository = no</span></span>
<span class="line"><span>concurrency = auto</span></span></code></pre></div><h3 id="legacy-version-file" tabindex="-1"><code>legacy_version_file</code> <a class="header-anchor" href="#legacy-version-file" aria-label="Permalink to &quot;\`legacy_version_file\`&quot;">​</a></h3><p><strong>지원되는</strong> 플러그인들은 다른 버전 매니저에서 사용되는 버전 파일들을 읽을 수 있습니다, 예를 들어, 루비의 <code>rbenv</code>에서 <code>.ruby-version</code>.</p>`,22)),e("table",p,[t[4]||(t[4]=e("thead",null,[e("tr",null,[e("th",{style:{"text-align":"left"}},"옵션"),e("th",{style:{"text-align":"left"}},"설명")])],-1)),e("tbody",null,[e("tr",null,[e("td",f,[t[0]||(t[0]=e("code",null,"no",-1)),t[1]||(t[1]=l()),o(d,{type:"tip",text:"기본",vertical:"middle"})]),t[2]||(t[2]=e("td",{style:{"text-align":"left"}},[l("버전을 불러오는 데는 "),e("code",null,".tool-versions"),l("를 사용합니다")],-1))]),t[3]||(t[3]=e("tr",null,[e("td",{style:{"text-align":"left"}},[e("code",null,"yes")]),e("td",{style:{"text-align":"left"}},[l("이용 가능한 레거시 버전 파일("),e("code",null,".ruby-version"),l(" 등)이 있는 경우 플러그인의 폴백으로 사용합니다")])],-1))])]),t[33]||(t[33]=e("h3",{id:"use-release-candidates",tabindex:"-1"},[e("code",null,"use_release_candidates"),l(),e("a",{class:"header-anchor",href:"#use-release-candidates","aria-label":'Permalink to "`use_release_candidates`"'},"​")],-1)),t[34]||(t[34]=e("p",null,[e("code",null,"asdf update"),l(" 명령어로 asdf를 최신 유의적 버전이 아닌 최신 버전 후보판으로 업그레이드 되도록 설정합니다.")],-1)),e("table",u,[t[9]||(t[9]=e("thead",null,[e("tr",null,[e("th",{style:{"text-align":"left"}},"옵션"),e("th",{style:{"text-align":"left"}},"설명")])],-1)),e("tbody",null,[e("tr",null,[e("td",g,[t[5]||(t[5]=e("code",null,"no",-1)),t[6]||(t[6]=l()),o(d,{type:"tip",text:"기본",vertical:"middle"})]),t[7]||(t[7]=e("td",{style:{"text-align":"left"}},"유의적 버전 사용",-1))]),t[8]||(t[8]=e("tr",null,[e("td",{style:{"text-align":"left"}},[e("code",null,"yes")]),e("td",{style:{"text-align":"left"}},"릴리스 후보판 사용")],-1))])]),t[35]||(t[35]=e("h3",{id:"always-keep-download",tabindex:"-1"},[e("code",null,"always_keep_download"),l(),e("a",{class:"header-anchor",href:"#always-keep-download","aria-label":'Permalink to "`always_keep_download`"'},"​")],-1)),t[36]||(t[36]=e("p",null,[e("code",null,"asdf install"),l(" 명령어로 다운로드하는 소스 코드 또는 바이너리를 유지 또는 제거하도록 설정합니다")],-1)),e("table",h,[t[14]||(t[14]=e("thead",null,[e("tr",null,[e("th",{style:{"text-align":"left"}},"옵션"),e("th",{style:{"text-align":"left"}},"설명")])],-1)),e("tbody",null,[e("tr",null,[e("td",y,[t[10]||(t[10]=e("code",null,"no",-1)),t[11]||(t[11]=l()),o(d,{type:"tip",text:"기본",vertical:"middle"})]),t[12]||(t[12]=e("td",{style:{"text-align":"left"}},"성공적인 설치 후 소스 코드 또는 바이너리 제거",-1))]),t[13]||(t[13]=e("tr",null,[e("td",{style:{"text-align":"left"}},[e("code",null,"yes")]),e("td",{style:{"text-align":"left"}},"설치 후 소스 코드 또는 바이너리 유지")],-1))])]),t[37]||(t[37]=e("h3",{id:"plugin-repository-last-check-duration",tabindex:"-1"},[e("code",null,"plugin_repository_last_check_duration"),l(),e("a",{class:"header-anchor",href:"#plugin-repository-last-check-duration","aria-label":'Permalink to "`plugin_repository_last_check_duration`"'},"​")],-1)),t[38]||(t[38]=e("p",null,"asdf 플러그인 리포지토리 동기화 간격(분)을 설정합니다. 트리거 이벤트는 지난 동기화 시간을 확인하게 합니다. 마지막 동기화 이후 지정된 동기화 간격보다 더 많은 시간이 경과하면, 새로운 동기화가 발생합니다.",-1)),e("table",b,[t[26]||(t[26]=e("thead",null,[e("tr",null,[e("th",{style:{"text-align":"left"}},"옵션"),e("th",{style:{"text-align":"left"}},"설명")])],-1)),e("tbody",null,[e("tr",null,[e("td",m,[t[15]||(t[15]=e("code",