http 저장소 규칙

@bazel_tools//tools/build_defs/repo:http.bzl에서 다음 함수를 로드할 수 있습니다.

http_Archive

http_archive(name, add_prefix, auth_patterns, build_file, build_file_content, canonical_id,
             integrity, netrc, patch_args, patch_cmds, patch_cmds_win, patch_tool, patches,
             remote_patch_strip, remote_patches, sha256, strip_prefix, type, url, urls,
             workspace_file, workspace_file_content)

Bazel 저장소를 압축된 보관 파일로 다운로드하고, 압축을 해제하고, 바인딩에 사용할 수 있게 만듭니다.

"zip", "jar", "war", "aar", "tar", "tar.gz", "tgz", "tar.xz", "txz", "tar.zst", "tzst", tar.bz2, "ar" 또는 "deb" 파일 확장자를 지원합니다.

예: 현재 저장소에 ~/chat-app 디렉터리에 기반한 채팅 프로그램의 소스 코드가 포함되어 있다고 가정해 보겠습니다. http://example.com/openssl.zip에서 사용할 수 있는 SSL 라이브러리를 사용해야 합니다. 이 .zip 파일에는 다음과 같은 디렉터리 구조가 포함되어 있습니다.

  WORKSPACE
  src/
    openssl.cc
    openssl.h

로컬 저장소에서 사용자가 다음 타겟 정의를 포함하는 openssl.BUILD 파일을 만듭니다.

  cc_library(
      name = "openssl-lib",
      srcs = ["src/openssl.cc"],
      hdrs = ["src/openssl.h"],
  )

다음 줄이 ~/chat-app/WORKSPACE에 추가되면 ~/chat-app 저장소의 대상이 이 대상에 종속될 수 있습니다.

  load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")

  http_archive(
      name = "my_ssl",
      url = "http://example.com/openssl.zip",
      sha256 = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
      build_file = "@//:openssl.BUILD",
  )

그러면 대상은 @my_ssl//:openssl-lib를 종속 항목으로 지정합니다.

속성

`name`	이름. 필수 항목입니다. 이 저장소의 고유한 이름입니다.
`add_prefix`	문자열, 선택사항 저장소 디렉터리를 기준으로 한 대상 디렉터리입니다. 보관 파일의 파일 경로에 `strip_prefix`(있는 경우)를 적용하면 보관 파일이 이 디렉터리에 압축 해제됩니다. 예를 들어 `add_prefix = "bar"` 및 `strip_prefix = "foo-1.2.3"`인 경우 `foo-1.2.3/src/foo.h` 파일이 `bar/src/foo.h`로 압축 해제됩니다.
`auth_patterns`	사전: 문자열 -> 문자열, 선택사항 호스트 이름을 커스텀 승인 패턴에 매핑하는 선택적 사전입니다. 이 사전에 URL의 호스트 이름이 있는 경우 이 값은 http 요청에 대한 승인 헤더를 생성할 때 패턴으로 사용됩니다. 이를 통해 많은 일반적인 클라우드 스토리지 제공업체에서 사용되는 커스텀 승인 스킴을 사용할 수 있습니다. 패턴은 현재 2개의 토큰(`<login>` 및 `<password>`)을 지원하며, 이 두 토큰은 netrc 파일에서 동일한 호스트 이름에 해당하는 값으로 대체됩니다. 형식을 지정한 후 결과는 HTTP 요청의 `Authorization` 필드 값으로 설정됩니다. Bearer 토큰을 사용하여 oauth2가 사용 설정된 API에 HTTP를 다운로드하는 속성 및 netrc의 예는 다음과 같습니다. auth_patterns = { "storage.cloudprovider.com": "Bearer <password>" } netrc: machine storage.cloudprovider.com password RANDOM-TOKEN 최종 HTTP 요청에는 다음 헤더가 있습니다. Authorization: Bearer RANDOM-TOKEN
`build_file`	라벨, 선택사항 이 저장소의 BUILD 파일로 사용할 파일입니다.이 속성은 절대 라벨입니다 (기본 저장소에 '@//' 사용). 파일 이름을 BUILD로 지정할 필요는 없지만, 이름을 지정할 수는 있습니다 (예: BUILD.new-repo-name과 같은 파일을 저장소의 실제 BUILD 파일과 구분하는 데 효과적일 수 있음). build_file 또는 build_file_content 중 하나를 지정할 수 있지만 둘 다 지정할 수는 없습니다.
`build_file_content`	문자열, 선택사항 이 저장소에 대한 BUILD 파일의 콘텐츠입니다. build_file 또는 build_file_content 중 하나를 지정할 수 있지만 둘 다 지정할 수는 없습니다.
`canonical_id`	문자열, 선택사항 다운로드한 보관 파일의 표준 ID입니다. bazel은 지정되고 비어 있지 않은 경우 동일한 표준 ID의 요청으로 캐시에 추가하지 않는 한 캐시에서 보관 파일을 가져오지 않습니다.
`integrity`	문자열, 선택사항 다운로드된 파일의 하위 리소스 무결성 형식으로 예상되는 체크섬입니다. 이 항목은 다운로드된 파일의 체크섬과 일치해야 합니다. _원격 파일은 변경될 수 있으므로 체크섬을 생략하면 보안상 위험합니다._ 이 필드를 생략하면 빌드가 기본 제공되지 않게 됩니다. 개발을 더 쉽게 하는 것은 선택사항이지만 배송 전에 이 속성 또는 `sha256` 을 설정해야 합니다.
`netrc`	문자열, 선택사항 인증에 사용할 .netrc 파일의 위치
`patch_args`	문자열 목록(선택사항) 패치 도구에 지정된 인수입니다. 기본값은 -p0이지만 일반적으로 git에서 생성된 패치에는 -p1이 필요합니다. -p 인수가 여러 개 지정된 경우 마지막 인수가 적용됩니다. -p 이외의 인수가 지정된 경우 Bazel은 Bazel 기반 패치 구현 대신 패치 명령줄 도구를 사용하도록 대체합니다. 패치 명령줄 도구로 대체하고 patch_tool 속성이 지정되지 않은 경우 `patch` 가 사용됩니다. 이는 `patches` 속성의 패치 파일에만 영향을 미칩니다.
`patch_cmds`	문자열 목록(선택사항) 패치를 적용한 후 Linux/Mac에 적용할 Bash 명령어 시퀀스
`patch_cmds_win`	문자열 목록(선택사항) 패치가 적용된 후 Windows에서 적용될 Powershell 명령어의 시퀀스 이 속성이 설정되지 않으면 Windows에서 patch_cmds가 실행되며, Bash 바이너리가 있어야 합니다.
`patch_tool`	문자열, 선택사항 사용할 패치(1) 유틸리티입니다. 이 플래그를 지정하면 Bazel이 Bazel 기반 패치 구현 대신 지정된 패치 도구를 사용합니다.
`patches`	라벨 목록, 선택사항 보관 파일을 추출한 후 패치로 적용할 파일 목록입니다. 기본적으로 퍼지 일치 및 바이너리 패치를 지원하지 않는 Bazel 기반 패치 구현을 사용하지만 'patch_tool' 속성이 지정되거나 'patch_args' 속성에 '-p' 이외의 인수가 있는 경우 Bazel은 패치 명령줄 도구를 대신 사용합니다.
`remote_patch_strip`	정수, 선택사항 원격 패치의 파일 이름에서 제거될 선행 슬래시 수입니다.
`remote_patches`	사전: 문자열 -> 문자열, 선택사항 패치 파일 URL의 무결성 값에 대한 맵으로, 보관 파일을 추출한 후 `patches` 속성에서 패치 파일을 적용하기 전에 적용됩니다. Bazel 기반 패치 구현을 사용합니다. `remote_patch_strip`을 사용하여 패치 스트립 번호를 지정할 수 있습니다.
`sha256`	문자열, 선택사항 다운로드된 파일의 예상 SHA-256입니다. 다운로드한 파일의 SHA-256과 일치해야 합니다. _SHA-256은 원격 파일이 변경될 수 있으므로 생략하면 보안상 위험합니다._ 이 필드를 생략하면 빌드가 기본 제공되지 않게 됩니다. 개발을 더 쉽게 하는 것은 선택사항이지만 이 속성 또는 '무결성'을 출시 전에 설정해야 합니다.
`strip_prefix`	문자열, 선택사항 추출된 파일에서 제거할 디렉터리 접두어입니다. 대부분의 보관 파일에는 유용한 모든 파일이 보관되어 있는 최상위 디렉터리가 포함되어 있습니다. 이 필드는 `build_file`에서 이 프리픽스를 반복해서 지정할 필요 없이 추출된 모든 파일에서 프리픽스를 삭제하는 데 사용할 수 있습니다. 예를 들어 `foo-lib-latest.zip`을 사용한다고 가정해 보겠습니다. 이 디렉터리에는 ‘foo-lib-1.2.3/’ 디렉터리가 있으며, 그 아래에는 `WORKSPACE` 파일이 있고 빌드하려는 실제 코드가 포함된 `src/`, `lib/`, `test/` 디렉터리가 있습니다. `foo-lib-1.2.3` 디렉터리를 최상위 디렉터리로 사용하려면 `strip_prefix = "foo-lib-1.2.3"`을 지정합니다. 이 디렉터리 외부에 있는 파일은 삭제되어 액세스할 수 없게 됩니다 (예: 최상위 라이선스 파일). 여기에는 프리픽스로 시작하지만 디렉터리에 없는 파일/디렉터리가 포함됩니다(예: `foo-lib-1.2.3.release-notes`). 지정된 프리픽스가 보관 파일 디렉터리와 일치하지 않으면 Bazel이 오류를 반환합니다.
`type`	문자열, 선택사항 다운로드한 파일의 보관 파일 유형입니다. 기본적으로 보관 파일 유형은 URL의 파일 확장자에 따라 결정됩니다. 파일에 확장자가 없는 경우 'zipzip', 'jar', 'war'', 'aar', 'tar.xz', 'txz', 'tar.zst', 'tar', 'z', 'bt.st' 또는 'tzst'를 명시적으로 지정할 수 있습니다.
`url`	문자열, 선택사항 Bazel에서 사용할 수 있는 파일 URL입니다. 파일(http 또는 https URL)이어야 합니다. 리디렉션이 이어집니다. 인증이 지원되지 않습니다. 가져올 URL을 지정할 수 있는 urls 매개변수를 사용하면 유연성을 높일 수 있습니다.
`urls`	문자열 목록(선택사항) Bazel에서 사용할 수 있는 파일의 URL 목록입니다. 각 항목은 파일(http 또는 https URL)이어야 합니다. 리디렉션이 이어집니다. 인증이 지원되지 않습니다. URL은 성공할 때까지 순서대로 시도되므로 먼저 로컬 미러링을 나열해야 합니다. 모든 다운로드가 실패하면 규칙이 실패합니다.
`workspace_file`	라벨, 선택사항 이 저장소의 `WORKSPACE` 파일로 사용할 파일입니다. `workspace_file` 또는 `workspace_file_content` 를 지정하거나 둘 다 지정할 수 없습니다.
`workspace_file_content`	문자열, 선택사항 이 저장소에 대한 WORKSPACE 파일의 콘텐츠 `workspace_file` 또는 `workspace_file_content` 를 지정하거나 둘 다 지정할 수 없습니다.

http_file

http_file(name, auth_patterns, canonical_id, downloaded_file_path, executable, integrity, netrc,
          sha256, url, urls)

URL에서 파일을 다운로드하여 파일 그룹으로 사용할 수 있도록 합니다.

예: 커스텀 규칙에 debian 패키지가 있어야 한다고 가정해 보겠습니다. 이 패키지는 http://example.com/package.deb에서 제공됩니다. 그런 다음 WORKSPACE 파일에 추가할 수 있습니다.

  load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_file")

  http_file(
      name = "my_deb",
      url = "http://example.com/package.deb",
      sha256 = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  )

타겟은 이 파일에 종속되는 종속 항목으로 @my_deb//file를 지정합니다.

속성

`name`	이름. 필수 항목입니다. 이 저장소의 고유한 이름입니다.
`auth_patterns`	사전: 문자열 -> 문자열, 선택사항 호스트 이름을 커스텀 승인 패턴에 매핑하는 선택적 사전입니다. 이 사전에 URL의 호스트 이름이 있는 경우 이 값은 http 요청에 대한 승인 헤더를 생성할 때 패턴으로 사용됩니다. 이를 통해 많은 일반적인 클라우드 스토리지 제공업체에서 사용되는 커스텀 승인 스킴을 사용할 수 있습니다. 패턴은 현재 2개의 토큰(`<login>` 및 `<password>`)을 지원하며, 이 두 토큰은 netrc 파일에서 동일한 호스트 이름에 해당하는 값으로 대체됩니다. 형식을 지정한 후 결과는 HTTP 요청의 `Authorization` 필드 값으로 설정됩니다. Bearer 토큰을 사용하여 oauth2가 사용 설정된 API에 HTTP를 다운로드하는 속성 및 netrc의 예는 다음과 같습니다. auth_patterns = { "storage.cloudprovider.com": "Bearer <password>" } netrc: machine storage.cloudprovider.com password RANDOM-TOKEN 최종 HTTP 요청에는 다음 헤더가 있습니다. Authorization: Bearer RANDOM-TOKEN
`canonical_id`	문자열, 선택사항 다운로드한 보관 파일의 표준 ID입니다. bazel은 지정되고 비어 있지 않은 경우 동일한 표준 ID의 요청으로 캐시에 추가하지 않는 한 캐시에서 보관 파일을 가져오지 않습니다.
`downloaded_file_path`	문자열, 선택사항 다운로드한 파일에 할당된 경로
`executable`	불리언, 선택사항 다운로드된 파일을 실행 가능하게 만들어야 하는지 여부입니다.
`integrity`	문자열, 선택사항 다운로드된 파일의 하위 리소스 무결성 형식으로 예상되는 체크섬입니다. 이 항목은 다운로드된 파일의 체크섬과 일치해야 합니다. _원격 파일은 변경될 수 있으므로 체크섬을 생략하면 보안상 위험합니다._ 이 필드를 생략하면 빌드가 기본 제공되지 않게 됩니다. 개발을 더 쉽게 하는 것은 선택사항이지만 배송 전에 이 속성 또는 `sha256` 을 설정해야 합니다.
`netrc`	문자열, 선택사항 인증에 사용할 .netrc 파일의 위치
`sha256`	문자열, 선택사항 다운로드된 파일의 예상 SHA-256입니다. 다운로드한 파일의 SHA-256과 일치해야 합니다. _SHA-256은 원격 파일이 변경될 수 있으므로 생략하면 보안상 위험합니다._ 이 필드를 생략하면 빌드가 기본 제공되지 않게 됩니다. 개발을 더 쉽게 하는 것은 선택사항이지만 배송 전에 설정해야 합니다.
`url`	문자열, 선택사항 Bazel에서 사용할 수 있는 파일 URL입니다. 파일(http 또는 https URL)이어야 합니다. 리디렉션이 이어집니다. 인증이 지원되지 않습니다. 가져올 URL을 지정할 수 있는 urls 매개변수를 사용하면 유연성을 높일 수 있습니다.
`urls`	문자열 목록(선택사항) Bazel에서 사용할 수 있는 파일의 URL 목록입니다. 각 항목은 파일(http 또는 https URL)이어야 합니다. 리디렉션이 이어집니다. 인증이 지원되지 않습니다. URL은 성공할 때까지 순서대로 시도되므로 먼저 로컬 미러링을 나열해야 합니다. 모든 다운로드가 실패하면 규칙이 실패합니다.

http_jar

http_jar(name, auth_patterns, canonical_id, downloaded_file_name, integrity, netrc, sha256, url,
         urls)

URL에서 jar를 다운로드하고 java_import로 사용 가능하도록 설정

다운로드한 파일의 확장자는 .jar여야 합니다.

예: 현재 저장소에 ~/chat-app 디렉터리에 루팅된 채팅 프로그램의 소스 코드가 포함되어 있다고 가정해 보겠습니다. http://example.com/openssl-0.2.jar에서 사용할 수 있는 SSL 라이브러리에 종속되어야 합니다.

다음 줄이 ~/chat-app/WORKSPACE에 추가되면 ~/chat-app 저장소의 대상이 이 대상에 종속될 수 있습니다.

  load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_jar")

  http_jar(
      name = "my_ssl",
      url = "http://example.com/openssl-0.2.jar",
      sha256 = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  )

타겟은 <code>@my_ssl//jar</code>를 이 jar에 종속되는 종속 항목으로 지정합니다.

Unix 기반 시스템을 사용하는 경우 'file:///path/to/file'을 사용하여 현재 시스템 (localhost)의 파일을 참조할 수도 있습니다. Windows를 사용하는 경우 'file:///c:/path/to/file'을 사용합니다. 두 예에서 모두 슬래시 3개 (/)에 주목하세요. 처음 2개 슬래시는 file://에 속하고 세 번째 슬래시는 파일의 절대 경로에 속합니다.

속성

`name`	이름. 필수 항목입니다. 이 저장소의 고유한 이름입니다.
`auth_patterns`	사전: 문자열 -> 문자열, 선택사항 호스트 이름을 커스텀 승인 패턴에 매핑하는 선택적 사전입니다. 이 사전에 URL의 호스트 이름이 있는 경우 이 값은 http 요청에 대한 승인 헤더를 생성할 때 패턴으로 사용됩니다. 이를 통해 많은 일반적인 클라우드 스토리지 제공업체에서 사용되는 커스텀 승인 스킴을 사용할 수 있습니다. 패턴은 현재 2개의 토큰(`<login>` 및 `<password>`)을 지원하며, 이 두 토큰은 netrc 파일에서 동일한 호스트 이름에 해당하는 값으로 대체됩니다. 형식을 지정한 후 결과는 HTTP 요청의 `Authorization` 필드 값으로 설정됩니다. Bearer 토큰을 사용하여 oauth2가 사용 설정된 API에 HTTP를 다운로드하는 속성 및 netrc의 예는 다음과 같습니다. auth_patterns = { "storage.cloudprovider.com": "Bearer <password>" } netrc: machine storage.cloudprovider.com password RANDOM-TOKEN 최종 HTTP 요청에는 다음 헤더가 있습니다. Authorization: Bearer RANDOM-TOKEN
`canonical_id`	문자열, 선택사항 다운로드한 보관 파일의 표준 ID입니다. bazel은 지정되고 비어 있지 않은 경우 동일한 표준 ID의 요청으로 캐시에 추가하지 않는 한 캐시에서 보관 파일을 가져오지 않습니다.
`downloaded_file_name`	문자열, 선택사항 다운로드된 jar에 파일 이름 할당
`integrity`	문자열, 선택사항 다운로드된 파일의 하위 리소스 무결성 형식으로 예상되는 체크섬입니다. 이 항목은 다운로드된 파일의 체크섬과 일치해야 합니다. _원격 파일은 변경될 수 있으므로 체크섬을 생략하면 보안상 위험합니다._ 이 필드를 생략하면 빌드가 기본 제공되지 않게 됩니다. 개발을 더 쉽게 하는 것은 선택사항이지만 배송 전에 이 속성 또는 `sha256` 을 설정해야 합니다.
`netrc`	문자열, 선택사항 인증에 사용할 .netrc 파일의 위치
`sha256`	문자열, 선택사항 다운로드된 파일의 예상 SHA-256입니다. 다운로드한 파일의 SHA-256과 일치해야 합니다. _SHA-256은 원격 파일이 변경될 수 있으므로 생략하면 보안상 위험합니다._ 이 필드를 생략하면 빌드가 기본 제공되지 않게 됩니다. 개발을 더 쉽게 하는 것은 선택사항이지만 이 속성 또는 '무결성'을 출시 전에 설정해야 합니다.
`url`	문자열, 선택사항 Bazel에서 사용할 수 있는 파일 URL입니다. 파일(http 또는 https URL)이어야 합니다. 리디렉션이 이어집니다. 인증이 지원되지 않습니다. 가져올 URL을 지정할 수 있는 urls 매개변수를 사용하면 유연성을 높일 수 있습니다. URL은 '.jar'로 끝나야 합니다.
`urls`	문자열 목록(선택사항) Bazel에서 사용할 수 있는 파일의 URL 목록입니다. 각 항목은 파일(http 또는 https URL)이어야 합니다. 리디렉션이 이어집니다. 인증이 지원되지 않습니다. URL은 성공할 때까지 순서대로 시도되므로 먼저 로컬 미러링을 나열해야 합니다. 모든 다운로드가 실패하면 규칙이 실패합니다. 모든 URL은 '.jar'로 끝나야 합니다.