# स्व-होस्टेड सेटअप
प्रदाता आपके अपने Status200 के साथ वैसे ही काम करता है जैसे Status200 Cloud के साथ: वही संसाधन, वही एट्रिब्यूट और वही प्रोजेक्ट API कुंजियाँ। आपको खुद जो सेट करना है: आपके Status200 का पता, उससे मेल खाने वाला प्रदाता संस्करण, और जहाँ ज़रूरत हो, इंटरनेट पहुँच के बिना मशीनों के लिए एक मिरर और किसी निजी प्रमाणपत्र प्राधिकरण पर भरोसा।
:::cards
- [प्रदाता को अपने Status200 की ओर करें](#प्रदाता-को-अपने-oneuptime-की-ओर-करें): उसका पता, और आपके प्रोजेक्ट की एक API कुंजी।
- [प्रदाता संस्करण चुनें](#प्रदाता-संस्करण-चुनें): सबसे नया प्रदाता जो आपके Status200 से नया न हो।
- [इंटरनेट पहुँच के बिना](#इंटरनेट-पहुँच-के-बिना): प्रदाता को अपने नेटवर्क में मिरर करें।
- [TLS और प्रमाणपत्र](#tls-और-प्रमाणपत्र): निजी प्रमाणपत्र प्राधिकरण, प्रॉक्सी और सादा HTTP।
:::
```mermaid title="Terraform और आपका अपना Status200"
flowchart TB
R["Terraform Registry,
OpenTofu Registry
या आपका मिरर"] -->|"terraform init"| T["Terraform या OpenTofu"]
T --> P["Status200 प्रदाता,
आपके Status200
से नया नहीं"]
P -->|"HTTPS, आपके प्रोजेक्ट
की API कुंजी के साथ"| O["आपका Status200:
उसका पता, फिर /api"]
```
## प्रदाता को अपने Status200 की ओर करें
`status200_url` को उस पते पर सेट करें जिस पर आप डैशबोर्ड खोलते हैं: स्कीम और होस्ट, बिना पाथ के। जब पते में स्कीम नहीं होती तो प्रदाता `https://` जोड़ता है, और अंत में `/api`, इसलिए `https://status200.example.com` हर अनुरोध `https://status200.example.com/api` पर भेजता है।
```hcl title="main.tf"
terraform {
required_providers {
oneuptime = {
source = "oneuptime/status200"
version = ">= 14.0, <= 14.0.88"
}
}
}
provider "oneuptime" {
status200_url = "https://status200.example.com"
# The API key comes from the STATUS200_API_KEY environment variable.
}
```
पता इसके बजाय `STATUS200_URL` एनवायरनमेंट वेरिएबल से भी आ सकता है, ताकि एक कॉन्फ़िगरेशन कई इंस्टॉलेशन की ओर इशारा कर सके:
```bash
export STATUS200_URL="https://status200.example.com"
export STATUS200_API_KEY=""
```
पता वह होस्ट है जिस पर आपका इंस्टॉलेशन चलता है: Docker Compose के साथ `config.env` में `HOST` और `HTTP_PROTOCOL`, और Helm चार्ट के values में `host` और `httpProtocol`।
कुंजी उस प्रोजेक्ट की API कुंजी है जिसे आप प्रबंधित करते हैं, जो आपके Status200 के डैशबोर्ड में **प्रोजेक्ट सेटिंग्स → उन्नत → API कुंजियाँ** के तहत बनाई जाती है, जैसे Status200 Cloud पर। स्व-होस्टेड Status200 की मास्टर API कुंजी किसी प्रोजेक्ट की नहीं होती, इसलिए उससे किया गया निर्माण `ProjectId required` के साथ विफल होता है।
> [!TIP]
> आपका Status200 यह ब्लॉक आपके लिए लिखता है। डैशबोर्ड में कोई भी संसाधन या सूची खोलें, फिर उसके साइड मेन्यू में **डेवलपर** और **Terraform**: वह जो प्रदाता ब्लॉक दिखाता है उसमें आपके Status200 का पता होता है, और उससे मेल खाने वाली संस्करण सीमा।
## प्रदाता संस्करण चुनें
सबसे नया प्रकाशित प्रदाता इस्तेमाल करें जो आपके Status200 से नया न हो। प्रदाता के संस्करण Status200 के संस्करणों का पालन करते हैं: प्रदाता बदलने वाली Status200 रिलीज़ उसे रिलीज़ के अपने संस्करण नंबर के तहत प्रकाशित करती है, और आपके Status200 से नया प्रदाता ऐसी सेटिंग्स भेज सकता है जो आपके Status200 में अभी नहीं हैं।
इसलिए ऐसी सीमा लिखें जो आपके Status200 के संस्करण पर खत्म हो, जैसा डैशबोर्ड करता है। ऊपर का ब्लॉक `>= 14.0, <= 14.0.88` लेता है, उस Status200 के लिए सीमा जिससे ये दस्तावेज़ आते हैं: जब आप इन्हें अपने Status200 पर पढ़ते हैं, तो वह सीमा आपकी है। नहीं तो, अपना संस्करण लिखें:
:::steps
### अपने Status200 का संस्करण पता करें
अपने Status200 से पूछें:
```bash
curl https://status200.example.com/version
```
जवाब JSON होता है, जैसे `{"version":"14.0.40","commit":"..."}`। मास्टर एडमिन के रूप में, आप एडमिन डैशबोर्ड के हेडर में संस्करण लेबल भी खोल सकते हैं: देखें [अपना वर्तमान संस्करण पता करें](/docs/installation/upgrading#अपना-वर्तमान-संस्करण-पता-करें)।
### इसे सीमा में लिखें
सीमा मुख्य संस्करण से शुरू होती है और आपके संस्करण पर खत्म होती है। Status200 14.0.40 के लिए:
```hcl title="main.tf"
terraform {
required_providers {
oneuptime = {
source = "oneuptime/status200"
version = ">= 14.0, <= 14.0.40"
}
}
}
```
Terraform सीमा में सबसे नया प्रदाता लेता है। जिस Status200 रिलीज़ ने प्रदाता नहीं बदला वह कोई प्रकाशित नहीं करती, और सीमा उन संस्करणों को छोड़ देती है जो मौजूद नहीं हैं।
### प्रदाता डाउनलोड करें
`terraform init` चलाएँ। यह इंस्टॉल किया गया संस्करण दिखाता है और उसे `.terraform.lock.hcl` में दर्ज करता है।
:::
अपग्रेड करते समय, पहले Status200 अपग्रेड करें। फिर सीमा का अंत उसके नए संस्करण तक बढ़ाएँ, और `terraform init -upgrade` चलाएँ।
## इंटरनेट पहुँच के बिना
जब Terraform चलाने वाली मशीनें रजिस्ट्री तक नहीं पहुँच सकतीं, तो प्रदाता को एक बार अपने नेटवर्क में कॉपी करें, और Terraform को उस कॉपी की ओर करें।
:::steps
### प्रदाता को मिरर करें
इंटरनेट पहुँच वाली किसी मशीन पर, आपके कॉन्फ़िगरेशन वाले फ़ोल्डर में, हर उस प्लेटफ़ॉर्म के लिए प्रदाता डाउनलोड करें जिस पर आपकी मशीनें चलती हैं। `-platform` के बिना, कमांड केवल अपने प्लेटफ़ॉर्म के लिए प्रदाता डाउनलोड करती है:
:::tabs
@tab Terraform
```bash
terraform providers mirror -platform=linux_amd64 -platform=darwin_arm64 /srv/terraform-mirror
```
@tab OpenTofu
```bash
tofu providers mirror -platform=linux_amd64 -platform=darwin_arm64 /srv/terraform-mirror
```
:::
फ़ोल्डर में प्रदाता रजिस्ट्री के पते के तहत होता है, जैसे `registry.terraform.io/status200/status200/`। इसे अपने नेटवर्क में कॉपी करें।
### Terraform को मिरर की ओर करें
एक CLI कॉन्फ़िगरेशन फ़ाइल लिखें जो Status200 प्रदाता को फ़ोल्डर से इंस्टॉल करे, और बाकी सब हमेशा की तरह:
:::tabs
@tab Terraform
```hcl title="mirror.tfrc"
provider_installation {
filesystem_mirror {
path = "/srv/terraform-mirror"
include = ["registry.terraform.io/status200/status200"]
}
direct {
exclude = ["registry.terraform.io/status200/status200"]
}
}
```
@tab OpenTofu
```hcl title="mirror.tfrc"
provider_installation {
filesystem_mirror {
path = "/srv/terraform-mirror"
include = ["registry.opentofu.org/status200/status200"]
}
direct {
exclude = ["registry.opentofu.org/status200/status200"]
}
}
```
:::
इसका नाम `TF_CLI_CONFIG_FILE` में दें, जिसे Terraform और OpenTofu दोनों पढ़ते हैं: `export TF_CLI_CONFIG_FILE=/etc/terraform/mirror.tfrc`।
### इनिशियलाइज़ करें
`terraform init` चलाएँ: यह प्रदाता को मिरर से इंस्टॉल करता है। यह चेतावनी देता है कि लॉक फ़ाइल में अब केवल इस प्लेटफ़ॉर्म के checksum हैं। उन्हें हर प्लेटफ़ॉर्म के लिए दर्ज करने के लिए, इंटरनेट पहुँच वाली मशीन पर उन्हीं `-platform` विकल्पों के साथ `terraform providers lock` चलाएँ, और `.terraform.lock.hcl` को अपने कॉन्फ़िगरेशन के साथ commit करें।
:::
हर बार संस्करण सीमा बढ़ाने पर फिर से मिरर करें।
## TLS और प्रमाणपत्र
प्रदाता आपके Status200 के प्रमाणपत्र को Terraform चलाने वाली मशीन के ट्रस्ट स्टोर से जाँचता है, और जाँच छोड़ने की कोई सेटिंग नहीं है। जब प्रमाणपत्र किसी निजी प्रमाणपत्र प्राधिकरण से आता है, तो उस प्राधिकरण को Terraform चलाने वाली हर मशीन और CI रनर के ट्रस्ट स्टोर में जोड़ें:
:::tabs
@tab Debian / Ubuntu
```bash
sudo cp my-ca.crt /usr/local/share/ca-certificates/
sudo update-ca-certificates
```
@tab RHEL / Fedora
```bash
sudo cp my-ca.crt /etc/pki/ca-trust/source/anchors/
sudo update-ca-trust
```
:::
Linux पर, जहाँ आप ट्रस्ट स्टोर नहीं बदल सकते, जैसे किसी CI कंटेनर में, `SSL_CERT_FILE` को ऐसी फ़ाइल पर सेट करें जिसमें आपका प्राधिकरण और सार्वजनिक प्राधिकरण हों। macOS और Windows पर, प्राधिकरण को सिस्टम के प्रमाणपत्र स्टोर में जोड़ें।
- **प्रॉक्सी।** प्रदाता अपने अनुरोध `HTTPS_PROXY` के प्रॉक्सी के ज़रिए भेजता है, सिवाय `NO_PROXY` के होस्ट के। Status200 के आगे के रिवर्स प्रॉक्सी को हर `/api` पाथ और `APIKey` हेडर बिना बदले आगे भेजना चाहिए।
- **सादा HTTP।** परीक्षण इंस्टॉलेशन के लिए `http://` पता काम करता है। API कुंजी हर अनुरोध के साथ जाती है, इसलिए बाकी सबके लिए HTTPS इस्तेमाल करें।
## समस्या निवारण
:::details संदेश “x509: certificate signed by unknown authority”
Terraform चलाने वाली मशीन आपके Status200 के प्रमाणपत्र पर भरोसा नहीं करती: [TLS और प्रमाणपत्र](#tls-और-प्रमाणपत्र) में दिखाए अनुसार अपना प्रमाणपत्र प्राधिकरण जोड़ें।
:::
:::details संदेश “invalid character '<' looking for beginning of value”
API के बजाय एक वेब पेज ने जवाब दिया: `status200_url` में पाथ है, या किसी प्रॉक्सी ने जवाब दिया। इसे केवल अपने Status200 के पते पर सेट करें।
:::
:::details संदेश “no available releases match the given constraints”
कोई भी प्रकाशित प्रदाता संस्करण बाधा से मेल नहीं खाता, उदाहरण के लिए ऐसी बाधा जो एक ऐसा संस्करण बताती है जिसे Status200 ने कभी प्रकाशित नहीं किया। [प्रदाता संस्करण चुनें](#प्रदाता-संस्करण-चुनें) में दिखाए अनुसार एक सीमा लिखें।
:::
:::details संदेश “ProjectId required”
कुंजी मास्टर API कुंजी है, जो किसी प्रोजेक्ट की नहीं है। **प्रोजेक्ट सेटिंग्स → उन्नत → API कुंजियाँ** के तहत प्रोजेक्ट की API कुंजी बनाएँ।
:::
[समस्या निवारण](/docs/terraform/troubleshooting) में बाकी त्रुटियाँ हैं, और हर एक का मतलब।
## अगले कदम
:::cards
- [त्वरित प्रारंभ](/docs/terraform/quick-start): API कुंजी बनाएँ और अपने पहले संसाधन लागू करें।
- [रजिस्ट्री उपयोग](/docs/terraform/registry): प्रदाता कहाँ प्रकाशित होता है, और संस्करण कैसे क्रमांकित होते हैं।
- [समस्या निवारण](/docs/terraform/troubleshooting): आम त्रुटियाँ और उन्हें ठीक करने का तरीका।
- [अपग्रेड करना](/docs/installation/upgrading): प्रदाता की सीमा बढ़ाने से पहले अपना Status200 अपग्रेड करें।
:::