img studio

คู่มือการตั้งค่าโครงสร้างพื้นฐานสำหรับ ImgStudio

0 เข้าถึง โมเดล Imagen

• โดยทั่วไปสำหรับ Vertex: ในคอนโซล (ใหม่!)
  • ไปที่ Vertex AI > Enable all recommended APIs
  • ซึ่งควรประกอบด้วย: Vertex AI API, Cloud Storage API
• สำหรับ Imagen Generation: ติดต่อผู้ติดต่อ Google Cloud ของคุณเพื่อรับสิทธิ์ในการเข้าถึงโมเดลการแก้ไข Imagen 3 - Imagen 3 Generate (imagen-3.0-generate-001) และ Imagen 3 Generate Fast (imagen-3.0-fast-generate-001)
• สำหรับการแก้ไข Imagen : ติดต่อผู้ติดต่อ Google Cloud ของคุณเพื่อขอการเข้าถึงตัวอย่างหรือรับการแจ้งเตือนเมื่อเป็น GA
  • สำหรับ Vertex Segmentation : คุณจะต้องเข้าถึงโมเดลใหม่นี้เช่นกันเมื่อใช้การแก้ไข

1 สร้างที่ เก็บข้อมูล Cloud Storage

• ข้อมูลจำเพาะ: ภูมิภาคในภูมิภาคที่คุณต้องการ (เช่น europe-west9 ในปารีส)
• สร้าง 3 ที่เก็บข้อมูล
  • เนื้อหาเอาต์พุตที่สร้างแบบดิบ : YOUR_COMPANY-imgstudio-output
  • เนื้อหาที่แบ่งปัน : YOUR_COMPANY-imgstudio-library
  • ที่เก็บข้อมูลไฟล์การกำหนดค่า : YOUR_COMPANY-imgstudio-export-config
    • ที่นี่ ให้อัปโหลดไฟล์การกำหนดค่า export-fields-options.json สำหรับการใช้งานของคุณ โดยเฉพาะ ซึ่งคุณสามารถหาตัวอย่างได้ในพื้นที่เก็บข้อมูล โดยมีวัตถุประสงค์คือเพื่อตั้งค่า ข้อมูลเมตา ที่คุณต้องการตั้งค่าสำหรับเนื้อหาที่คุณสร้างขึ้น
    • ในไฟล์นี้ สำหรับแต่ละ ฟิลด์ (เช่น: contextAuthorTeam, contextTargetPlatform, contextAssociatedBrand, contextCollection) คุณสามารถเปลี่ยนได้เฉพาะ ID ของฟิลด์ (เช่น: “contextAuthorTeam” ) ป้ายกำกับ (เช่น “In which team are you?” ) ชื่อ (เช่น: “Associated team(s)” ) แท็ก คือบังคับ (เช่น: true ) และสุดท้ายคือ ตัวเลือก
    • ความสนใจ! รหัสและค่าของตัวเลือกต้องเป็นตัวอักษรเท่านั้น ห้ามเว้นวรรค ไม่มีอักขระพิเศษ โดยขึ้นต้นด้วยตัวอักษรพิมพ์เล็ก

2 ตั้งค่าทริกเกอร์ Cloud Build

• ชื่อ: YOUR_COMPANY-imgstudio
• เหตุการณ์: Manual invocation
• แหล่งที่มา:
  • ไปที่พื้นที่เก็บข้อมูลสาธารณะ https://github.com/aduboue/img-studio
  • ติดตามรายการออกใหม่ เพื่อติดตามข่าวสารล่าสุด: คลิกที่ Watch > Custom > Releases > Apply
  • ใช้ปุ่มขวาบนเพื่อตั้งค่า GitHub fork จากพื้นที่เก็บข้อมูล ซึ่งจะ สร้างพื้นที่เก็บข้อมูลสำเนาในบัญชี GitHub ของคุณเอง
  • กลับไปที่ Cloud Build เข้าสู่ระบบบัญชี GitHub ของคุณ จากนั้นเลือกพื้นที่เก็บข้อมูลที่สร้างขึ้นใหม่
• การกำหนดค่า: Cloud Build configuration file (yaml or json)
  • ตำแหน่งไฟล์การกำหนดค่า Cloud Build: /cloudbuild.yaml
• ใส่ ตัวแปรทดแทน 7 ตัว:
  • _NEXT_PUBLIC_EXPORT_FIELDS_OPTIONS_URI
    • URI ของไฟล์ JSON การกำหนดค่าในที่เก็บข้อมูล
    • เช่น gs://YOUR_COMPANY-imgstudio-export-config/export-fields-options.json
  • _NEXT_PUBLIC_GCS_BUCKET_LOCATION
    • ภูมิภาคที่เลือกสำหรับที่เก็บข้อมูล GCS ของคุณ
    • เช่น europe-west9
  • _NEXT_PUBLIC_VERTEX_API_LOCATION
    • ภูมิภาคที่คุณต้องการใช้สำหรับ VertexAI API
    • เช่น europe-west9
  • _NEXT_PUBLIC_GEMINI_MODEL = gemini-1.5-flash-001
    • อย่าเปลี่ยนสิ่งนี้
  • _NEXT_PUBLIC_OUTPUT_BUCKET
    • ชื่อของที่เก็บข้อมูลเนื้อหาเอาต์พุตดิบที่สร้างขึ้น
    • เช่น YOUR_COMPANY-imgstudio-output
  • _NEXT_PUBLIC_TEAM_BUCKET
    • ชื่อของที่เก็บข้อมูลเนื้อหาที่แชร์
    • เช่น YOUR_COMPANY-imgstudio-library
  • _NEXT_PUBLIC_PRINCIPAL_TO_USER_FILTERS
    • ส่วนของที่อยู่อีเมลของผู้ใช้ของคุณที่ใช้ในการเข้าสู่ระบบผ่าน IAP ซึ่งจะต้องถูกลบออกเพื่อรับ ID ผู้ใช้ โดยคั่นด้วยเครื่องหมายจุลภาค
    • ตัวอย่าง: ที่อยู่อีเมลของฉันคือ '[email protected]' ค่าที่จะตั้งค่าจะเป็น admin-,@company.com เพื่อให้สามารถแยก ID ผู้ใช้ jdupont ได้
  • _NEXT_PUBLIC_EDIT_ENABLED (ใหม่!)
    • อนุญาตให้เปิดใช้งานคุณลักษณะการแก้ไข ตั้งค่าเป็น ' false ' หากคุณยังไม่มีสิทธิ์เข้าถึง
  • _NEXT_PUBLIC_EDIT_MODEL (ใหม่!)
    • จำเป็นเท่านั้นหากเปิดใช้งานการแก้ไข
    • ชื่อบริการสำหรับโมเดลแก้ไข เมื่อคุณเข้าถึงได้
  • _NEXT_PUBLIC_SEG_MODEL (ใหม่!)
    • จำเป็นเท่านั้นหากเปิดใช้งานการแก้ไข
    • ชื่อบริการสำหรับโมเดล Vertex Segmentation เมื่อคุณเข้าถึงได้
• บัญชีบริการ: เลือก บัญชีบริการ Cloud Build ที่มีอยู่แล้วเป็นค่าเริ่มต้น [email protected]
  • คุณอาจต้องการ ตรวจสอบใน IAM ซึ่งมีบทบาท : Artifact Registry Writer และ Logs Writer
• > บันทึก
• รันบิลด์แรกของคุณด้วยตนเอง !

3 เปิดใช้งาน IAP และกำหนดค่า หน้าจอยินยอม oAuth

• ไปที่ ความปลอดภัย > Identity Aware Proxy และเปิดใช้งาน API
• > กำหนดค่าหน้าจอยินยอม (oAuth)
  • ประเภทผู้ใช้ สามารถเป็นอย่างใดอย่างหนึ่ง
    • Internal หากคุณต้องการจำกัดผู้ใช้ IAP ไว้เฉพาะ โดเมนองค์กร GCP ของคุณ
    • External หากคุณมีผู้ใช้บางรายใน โดเมนที่แตกต่าง จากองค์กร GCP ของคุณ
  • > สร้าง
  • กรอก
    • ชื่อแอป: YOUR_COMPANY-imgstudio
    • อีเมลสนับสนุนผู้ใช้
    • โดเมนที่ได้รับอนุญาต: YOUR_COMPANY_DOMAIN
    • อีเมลติดต่อผู้พัฒนา
  • > บันทึกและดำเนินการต่อ
• เพิ่ม ขอบเขต ที่จำเป็นหรือ > บันทึกและดำเนินการต่อ
• ตรวจสอบ ข้อมูลสรุป
• > กลับไปที่แดชบอร์ด

4 สร้าง บัญชีบริการ แอปพลิเคชัน

• ไปที่ IAM > บัญชีบริการ > สร้างบัญชีบริการ
• ระบุชื่อ: YOUR_COMPANY-imgstudio-sa
• ให้ บทบาท :
  • Cloud Datastore User
  • Logs Writer
  • Secret Manager Secret Accessor
  • Service Account Token Creator
  • Storage Object Creator
  • Storage Object Viewer
  • Vertex AI User

5 ปรับใช้บริการ Cloud Run

• ปรับใช้คอนเทนเนอร์ > บริการ
• Deploy one revision from an existing container image
• อิมเมจคอนเทนเนอร์ > เลือกอิมเมจ latest ที่คุณเพิ่งสร้างใน Cloud Build จาก รีจิสทรี Artifact
• ชื่อ: YOUR_COMPANY-imgstudio-app
• ตั้งค่าภูมิภาคของคุณ (เช่น europe-west9 )
• การรับรองความถูกต้อง : ต้องมีการรับรองความถูกต้อง
• การควบคุมข้อมูลขาเข้า > Internal > Allow traffic from external Application Load Balancers
• คอนเทนเนอร์ > พอร์ตคอนเทนเนอร์: 3000
• ความปลอดภัย > บัญชีบริการ: YOUR_COMPANY-imgstudio-sa
• > สร้าง
• หมายเหตุ: หากคุณพยายามเข้าถึง URL ที่เผยแพร่สำหรับบริการใหม่ คุณควรได้รับข้อความแสดงข้อผิดพลาดระบุว่า "ข้อผิดพลาด: ไม่พบหน้าเว็บ" นี่เป็นเพราะว่าเราอนุญาตให้เฉพาะทางเข้าสำหรับการรับส่งข้อมูลภายนอกจาก Load Balancer

6 ให้ สิทธิ์ IAP บนบริการ Cloud Run

• สร้าง ที่อยู่บัญชีบริการ IAP
  • ไปที่ด้านบนขวาของคอนโซล > ไอคอนเชลล์ “เปิดใช้งาน Cloud Shell”
  • รอให้เครื่องตั้งค่า
  • ในเทอร์มินัล ให้ใช้คำสั่งนี้และ คัดลอกที่อยู่บัญชีบริการเอาต์พุต
    • gcloud beta services identity create --service=iap.googleapis.com --project=PROJECT_ID
  • รูปแบบของเอาต์พุตที่คุณสามารถคัดลอกได้ควรเป็น [email protected]
• ไปที่ Cloud Run ในรายการบริการ เลือกช่องทำเครื่องหมายถัดจากชื่อบริการของคุณ
  • คลิกที่ การอนุญาต > เพิ่มอาจารย์ใหญ่
  • มอบบทบาท Cloud Run Invoker ให้กับ บัญชีบริการ IAP ที่สร้าง/ดึงข้อมูลไว้ก่อนหน้านี้

7 สร้าง โซน DNS

• บริการเครือข่าย > Cloud DNS
• > สร้างโซน
• กรอกแบบฟอร์ม
  • ชื่อโซน: imgstudio
  • ชื่อ DNS : imgstudio.YOUR_COMPANY_DOMAIN
  • DNSSEC: Off
  • การบันทึกบนคลาวด์: Off
• เมื่อการเผยแพร่ DNS เสร็จสมบูรณ์ ให้ตรวจสอบเนมเซิร์ฟเวอร์ของโซนที่มีการจัดการ DNS โดยใช้คำสั่งด้านล่าง (อาจใช้เวลาหลายชั่วโมงจึงจะเสร็จสมบูรณ์)
  • dig imgstudio.YOUR_COMPANY_DOMAIN NS +short

8 สร้าง โหลดบาลานเซอร์ และ ใบรับรอง SSL

• บริการเครือข่าย > โหลดบาลานซ์
• > สร้างโหลดบาลานเซอร์
• เลือก:
  • ประเภทของ Load Balancer : Application Load Balancer (HTTP/HTTPS)
  • หันหน้าสู่สาธารณะหรือภายใน : Public Facing (external)
  • ทั่วโลกหรือภูมิภาคเดียว : Global
  • การสร้าง Load Balancer : Global external Application Load Balancer
• > กำหนดค่า
• ชื่อโหลดบาลานเซอร์: YOUR_COMPANY-imgstudio-lb
• การกำหนดค่าส่วนหน้า:
  • โปรโตคอล : HTTPS
  • ที่อยู่ IP สามารถทิ้งไว้ Ephemeral (คุณสามารถกำหนดค่า IP แบบคงที่ได้ด้วย)
  • รายการแบบเลื่อนลง ใบรับรอง > สร้างใบรับรองใหม่
    • ชื่อ: YOUR_COMPANY-imgstudio-cert
    • > สร้างใบรับรองที่จัดการโดย Google
    • โดเมน 1 : imgstudio.YOUR_COMPANY_DOMAIN
    • > สร้าง
  • > เสร็จแล้ว
• การกำหนดค่าแบ็กเอนด์
  • บริการแบ็กเอนด์และที่เก็บข้อมูลแบ็กเอนด์ > สร้าง บริการแบ็กเอนด์
  • ชื่อ: YOUR_COMPANY-imgstudio-back
  • ประเภทแบ็กเอนด์ : Serverless Network Endpoint Group > เสร็จสิ้น
  • แบ็กเอนด์ > แบ็กเอนด์ใหม่ > กลุ่มจุดสิ้นสุดเครือข่ายแบบไร้เซิร์ฟเวอร์ แบบเลื่อนลง > สร้างกลุ่มจุดสิ้นสุดเครือข่ายแบบไร้เซิร์ฟเวอร์
    • ชื่อ: YOUR_COMPANY-imgstudio-neg
    • ภูมิภาค: ภูมิภาคที่ให้บริการ Cloud Run ใช้งานได้ (เช่น europe-west9 )
    • ประเภทกลุ่มปลายทางเครือข่ายแบบไร้เซิร์ฟเวอร์ > Cloud Run > เลือกบริการ > YOUR_COMPANY-imgstudio-app > สร้าง
    • เปิดใช้งาน Cloud CDN > Off
    • > สร้าง
• ตรวจสอบการกำหนดค่าตัวจัดสรรภาระงาน
• > สร้าง

9 สร้าง บันทึก DNS สำหรับส่วนหน้าของ Load Balancer

• บริการเครือข่าย > โหลดบาลานซ์ เลือกโหลดบาลานเซอร์ของคุณ YOUR_COMPANY-imgstudio-lb
• รายละเอียด > ส่วนหน้า > IP-Port
• สังเกต ที่อยู่ IP
• บริการเครือข่าย > Cloud DNS เลือกโซน DNS ของคุณ imgstudio
• ชุดเรกคอร์ด > เพิ่มมาตรฐาน
• สร้าง ชุดบันทึก
  • ชื่อ DNS: imgstudio.YOUR_COMPANY_DOMAIN
  • ที่อยู่ IPv4 : ที่อยู่ IP ของโหลดบาลานเซอร์ของคุณ
  • > สร้าง

10 เปิดใช้งาน IAP และให้สิทธิ์ การเข้าถึงแก่ผู้ใช้

• ความปลอดภัย > Identity-Aware Proxy
• เปิด IAP สำหรับ บริการแบ็กเอนด์ ของคุณ YOUR_COMPANY-imgstudio-back
• เลือกช่องทำเครื่องหมายถัดจากบริการของคุณ จากนั้น > เพิ่ม อาจารย์ใหญ่
• ป้อนที่อยู่ของผู้ใช้ ( หรือกลุ่ม ) ที่คุณต้องการอนุญาตให้เข้าถึง imgstudio
• มอบหมายบทบาท IAP-secured Web App User > บันทึก

11 การสร้างฐานข้อมูล Firestore

• Firestore > สร้างฐานข้อมูล
  • โหมด Firestore : Native mode > ดำเนินการต่อ
  • ID ฐานข้อมูล : (default) ( สำคัญมากที่คุณต้องเก็บไว้อย่างนั้น )
  • ประเภทสถานที่ตั้ง: Region
  • ภูมิภาค: ภูมิภาคที่คุณต้องการ (เช่น europe-west9 ในปารีส)
  • กฎที่ปลอดภัย: Production rules
• Firestore > ดัชนี > ดัชนีคอมโพสิต > สร้างดัชนี
  • รหัสคอลเลกชัน : metadata
  • ฟิลด์ที่จะจัดทำดัชนี
    • พาธฟิลด์ 1: combinedFilters ตัวเลือกดัชนี 1: Array contains
    • เส้นทางฟิลด์ 2: timestamp ตัวเลือกดัชนี 2: Descending
    • เส้นทางฟิลด์ 3: __name__ ตัวเลือกดัชนี 3: Descending
  • ขอบเขต การค้นหา : Collection
  • > สร้าง
  • รอให้สร้างดัชนีสำเร็จ!
• มา ตั้งค่ากฎความปลอดภัยในฐานข้อมูลของคุณ และอนุญาตให้เฉพาะบัญชีบริการ Cloud Run ของคุณเข้าถึงได้
  • ในแท็บใหม่ ให้ไปที่
    • https://console.firebase.google.com/project/PROJECT_ID/firestore/databases/-default-/rules
    • หากจำเป็น ให้ทำตามขั้นตอนเพื่อ ตั้งค่าโปรเจ็กต์ Firebase
    • เมื่ออยู่ในฐานข้อมูล Firestore > กฎ ให้ไปที่ ตัวแก้ไขกฎความปลอดภัย
    • เขียนเนื้อหาต่อไปนี้ อย่าลืมแทนที่ YOUR_COMPANY & PROJECT_ID ในบัญชีบริการ Cloud Run rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { match /{document=**} { allow read, get, list, create, update: if get(/databases/$(database)/documents/request.auth.uid).data.serviceAccount == 'YOUR_COMPANY-imgstudio-sa@PROJECT_ID.iam.gserviceaccount.com'; allow delete: if false; }}}
    • > เผยแพร่