go tfe download - go tfe source code download

go tfe

شفرة المصدر الأخرى

v1.70.0

تنزيل

HCP Terraform و Terraform Enterprise Go Client

عميل GO API الرسمي لـ HCP Terraform و Terraform Enterprise.

يدعم هذا العميل HCP Terraform V2 API. نظرًا لأن Terraform Enterprise هو توزيع مستضيف ذاتي لـ HCP Terraform ، فإن هذا العميل يدعم كل من حالات استخدام HCP Terraform و Terraform. في جميع وثائق الحزم وواجهة API ، سيتم دائمًا ذكر المنصة على أنها "Terraform Enterprise" - ولكن سيتم ملاحظة ميزة بشكل صريح على أنها مدعومة فقط في واحد أو آخر ، إن أمكن (نادر).

معلومات الإصدار

دائمًا ما تشير تغييرات الإصدار البسيطة إلى الميزات والتحسينات المتوافقة مع الإصدارات السابقة. في بعض الأحيان ، قد تظهر تغييرات توقيع الوظائف التي تعكس إصلاح الأخطاء كتغيير إصدار بسيط. سيتم استخدام تغييرات إصدار التصحيح لإصلاحات الأخطاء ، وتحسينات الأداء ، والتغييرات غير المناسبة.

مثال الاستخدام

قم ببناء عميل TFE جديد ، ثم استخدم نقاط النهاية المختلفة على العميل للوصول إلى أجزاء مختلفة من API 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 )
}

باستخدام التكوين الافتراضي مع env vars

يستفيد التكوين الافتراضي من متغيرات بيئة TFE_ADDRESS و TFE_TOKEN .

TFE_ADDRESS - عنوان URL من مثيل HCP Terraform أو Terraform Enterprise. مثال: https://tfe.local
TFE_TOKEN - رمز API لمثيل HCP Terraform أو Terraform Enterprise.

ملاحظة: بدلاً من ذلك ، يمكنك تعيين TFE_HOSTNAME الذي يعمل بمثابة احتياطي لـ TFE_ADDRESS . سيتم استخدامه فقط إذا لم يتم تعيين 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 )
}