go tfe
v1.70.0
HCP Terraform 및 Terraform Enterprise의 공식 GO API 클라이언트.
이 클라이언트는 HCP Terraform V2 API를 지원합니다. Terraform Enterprise는 HCP Terraform의 자체 호스팅 분포 이므로이 클라이언트는 HCP Terraform 및 Terraform Enterprise 사용 사례를 모두 지원합니다. 모든 패키지 문서와 API에서 플랫폼은 항상 'Terraform Enterprise'로 언급되지만 기능은 해당되는 경우 (희귀) (희귀)에만 지원되는 것으로 명시 적으로 언급됩니다.
거의 항상 사소한 버전 변경은 후진 호환 기능 및 향상을 나타냅니다. 때로는 버그 수정을 반영하는 기능 서명 변경이 사소한 버전 변경으로 나타날 수 있습니다. 패치 버전 변경은 버그 수정, 성능 향상 및 그렇지 않으면 충격적인 변경에 사용됩니다.
새로운 TFE 클라이언트를 구성한 다음 클라이언트의 다양한 엔드 포인트를 사용하여 TerraForm Enterprise API의 다른 부분에 액세스하십시오. 다음 예제에는 모든 조직이 나와 있습니다.
import (
"context"
"log"
"github.com/hashicorp/go-tfe"
)
config := & tfe. Config {
Address : "https://tfe.local" ,
Token : "insert-your-token-here" ,
RetryServerErrors : true ,
}
client , err := tfe . NewClient ( config )
if err != nil {
log . Fatal ( err )
}
orgs , err := client . Organizations . List ( context . Background (), nil )
if err != nil {
log . Fatal ( err )
} 기본 구성은 TFE_ADDRESS 및 TFE_TOKEN 환경 변수를 사용합니다.
TFE_ADDRESS HCP Terraform 또는 Terraform Enterprise 인스턴스의 URL. 예 : https://tfe.localTFE_TOKEN HCP TerraForm 또는 TerraForm Enterprise 인스턴스의 API 토큰. 참고 : 또는 TFE_ADDRESS 의 폴백 역할을하는 TFE_HOSTNAME 설정할 수 있습니다. TFE_ADDRESS 설정되지 않은 경우에만 사용되며 호스트를 https 구성표로 해결합니다. 예 : tfe.local =>는 https://tfe.local 로 해결됩니다
환경 변수는 주소 또는 토큰 값이 아래의 경우와 같이 제공되지 않는 경우 TFE 클라이언트를 구성하기위한 폴백으로 사용됩니다.
import (
"context"
"log"
"github.com/hashicorp/go-tfe"
)
// Passing nil to tfe.NewClient method will also use the default configuration
client , err := tfe . NewClient ( tfe . DefaultConfig ())
if err != nil {
log . Fatal ( err )
}
orgs , err := client . Organizations . List ( context . Background (), nil )
if err != nil {
log . Fatal ( err )
} import (
"context"
"log"
"github.com/hashicorp/go-tfe"
)
config := & tfe. Config {
Address : "" ,
Token : "" ,
}
client , err := tfe . NewClient ( config )
if err != nil {
log . Fatal ( err )
}
orgs , err := client . Organizations . List ( context . Background (), nil )
if err != nil {
log . Fatal ( err )
}API 클라이언트를 완전히 사용하려면 전체 패키지 문서를 참조하십시오.
이 API 클라이언트는 대부분의 기존 HCP TerraForm API 호출을 다루며 정기적으로 업데이트되어 새 또는 누락 된 엔드 포인트를 추가합니다.
예제 디렉토리를 참조하십시오.
tests.md를 참조하십시오.
Contributing.md를 참조하십시오
Releases.md를 참조하십시오
