Bulut ortamları

Codex Cloud, kodlama görevlerini bulutta çalıştırır; böylece bilgisayarınız uyku modundayken de çalışmalar devam edebilir. Kod düzenlemek, komut çalıştırmak ve sonuçları incelemek için web'de, mobil cihazlarda veya masaüstü uygulamasında kullanın.

Bulut ortamı, görevlerin kullandığı yeniden kullanılabilir yapılandırmadır: depolar, bağımlılıklar, araçlar ve erişim ayarları. Codex depolarınızı inceler, kurulumu hazırlar ve sizinle birlikte test eder. Her yeni görev, yayımlanan ortamdan oluşturulan kendi yalıtılmış çalışma alanına sahip olur.

Giriş niteliğinde bilgi için Codex Cloud'a genel bakış sayfasına bakın.

Codex Cloud'da bir görev başlatın

Web’de veya masaüstü uygulamasında Çalışma yeri > Bulut seçeneğini seçin ve yayımlanmış bir ortam seçin. Mobil cihazınızda Codex bölümünü açıp yayımlanmış bir ortam seçin. Codex’in ne yapmasını istediğinizi açıklayın ve isteği gönderin. Yeni bir kuruluma ihtiyacınız varsa web’de veya masaüstü uygulamasında bir ortam oluşturun ve kurulumu buradan yapın.

Enterprise yöneticileri, Codex Cloud'u kullanıma sunmadan önce çalışma alanı erişimini inceleyebilir .

Bir ortam oluşturun ve yayımlayın

Web’de veya masaüstü uygulamasında yeni ortamlar oluşturun. ChatGPT hesabınızla oturum açın:

1. Yeni bir görevde Çalışma yeri > Bulut seçeneğini seçin, Ortam seç menüsünü açın ve Ortam oluştur seçeneğini seçin.
2. Çalışma kopyası oluşturulacak GitHub depolarını seçin. İstenirse GitHub'ı bağlayın.
3. Başlayın seçeneğini seçin. Codex depoları inceler, bağımlılıkları ve araçları yükler, ardından iş akışını test eder.
4. İstendiğinde eksik erişimi veya bilgileri sağlayın. Belirli sürümler, komutlar veya hizmetler de isteyebilirsiniz.
5. Kurulum raporunu, yapılandırmayı ve dosyaları inceleyin. Tamamlanmamış işleri sonuçlandırın, değişiklikleri kaydedin ve Yayımla seçeneğini seçin.
6. Ortam yayımlandı mesajı göründükten sonra Yeni bir görev başlat seçeneğini seçin ve Codex'in ne yapmasını istediğinizi açıklayın.

Ayarlar > Codex Cloud > Ortamlar > Ortam oluştur yolundan da başlayabilirsiniz.

Yükleme ve başlatma işlemlerini özelleştirin

Codex, depolarınızdan çalışma zamanlarını, paket sürümlerini, araçları ve hizmetleri belirler. Kurulumu sohbet içinde şekillendirin; kendiniz bir kurulum betiği yazmanız gerekmez.

Codex, test edilen kurulumu iki alana kaydedebilir:

• Kurulum betiği: bağımlılıkları yüklemek ve geliştirme varlıklarını hazırlamak için komutlar.
• Başlatma skill’i: hizmetleri başlatmak ve hazır olduklarını kontrol etmek için talimatlar.

Kaydedilmiş durumu yeniden kullanın ve güncelleyin

• Yeni görev: yayımlanan ortamın hazırlanmış dosya sisteminden başlar.
• Mevcut görev: commit edilmemiş değişiklikler ve yüklenmiş araçlar dahil, kendi kaydedilmiş dosyalarıyla devam eder.
• Depo yenileme: yükleme veya başlatma komutlarını yeniden çalıştırmadan bağımlılık önbelleklerini koruyarak arka planda otomatik olarak çalışır.

Yeniden kullanılabilir yapılandırmayı güncellemek için Ayarlar > Codex Cloud > Ortamlar yolunu açın. Ortamın … menüsünden Düzenle seçeneğini seçin. Değişikliği açıklayın, Codex'in hazırlayıp test etmesini bekleyin, değişiklikleri kaydedin ve Yeniden yayımla seçeneğini seçin. Güncellemeyi kullanmak için yeni bir görev başlatın; mevcut görevler kendi durumlarını korur.

Önemli çalışmalarınızı commit edin veya ihtiyaç duyduğunuz çıktıyı kaydedin. Kaydedilmiş durum, sürüm kontrolünün yerini tutmaz.

Ortam değişkenlerini ve ağ gizli bilgilerini yapılandırın

Codex eksik yapılandırmayı belirler ve çıkarım yapamadığı değerleri ister. Ortam yapılandırmasında Ortam değişkenleri veya Ağ gizli bilgileri yanındaki Yönet seçeneğini seçin. Her değeri nasıl sağlayacağınızı belirleyin:

Ağ gizli bilgileri için Anahtar, Değer ve İzin verilen alan adları alanlarını ayarlayın. Doğrudan iletilen değişkenlerden farklı bir anahtar kullanın. Değer değiştirme, kurulum ve görevler sırasında 443 numaralı bağlantı noktasındaki HTTPS için çalışır; ham kimlik bilgisini yerel bir sürece veya dosyaya yerleştirmez.

Ortama ait ağ gizli bilgileri kaydedildiğinde bunların hedefleri kısıtlı internet erişimine eklenir. Doğrudan iletilen değişkenler ve kişisel değerler hedef eklemez. Test etmeden önce kaydedilmiş ağ politikasını inceleyin. Çalışma alanı gereksinimleri için Agent Security sayfasına bakın.

Kişisel değerleri sağlayın

Çalışma alanınızdaki bulut ortamları için kendi ortam değişkenlerinizi ve ağ gizli bilgilerinizi kaydetmek üzere Kişisel kasa özelliğini kullanın.

Paylaşılan bir ortam, her kişinin kendi hesabından sağlayacağı değerler isteyebilir. Ortam paylaşıldığında kişisel kimlik bilgileriniz değil, bu gereksinimler paylaşılır.

İstendiğinde Kişisel gizli bilgiler ekle bölümüne gerekli değerleri girin ve Kaydet ve başlat seçeneğini seçin. İsteğe bağlı değerler ayarlanmadan bırakılabilir.

Değerleri önceden yönetmek için:

1. Ayarlar > Codex Cloud yolunu açın, ardından Kişisel kasa sekmesini seçin.
2. Ekle seçeneğini seçin, Tür altında Ortam değişkeni veya Ağ gizli bilgisi seçeneğini belirleyin ve eşleşen Anahtar ile kendi Değer bilginizi girin.
3. Geçerli olduğu ortamlar altında Tüm ortamlar veya Seçili ortamlar seçeneğini, ardından Kaydet seçeneğini seçin.

Bir göreve yalnızca istenen değerler ulaşır. Belirli bir ortama ait değer, genel varsayılan değere göre önceliklidir. Kişisel ağ gizli bilgileri, ortamın izin verilen hedeflerini kullanır ve yer tutucuları aynı şekilde değiştirir.

Bir Enterprise çalışma alanında paylaşın

İş arkadaşlarınızın kendi görevlerini başlatabilmesi için hazırlanmış bir yapılandırmayı paylaşın:

1. Ortamın yapılandırmasını açın.
2. Gizlilik > Kimler kullanabilir altında çalışma alanınızı seçin.
3. Değişikliği kaydedin. Henüz yayımlamadıysanız ortamı yayımlayın.

Ortamı özel tutmak için Kimler kullanabilir altında Yalnızca ben seçeneğini seçin. Her görevin çalışma dosyaları ayrıdır; yapılandırmaya erişim, başkasının görevine erişim veya ortamı düzenleme izni vermez.

Paylaşmadan önce hazırlanmış dosyaları ve ortama ait kimlik bilgilerini inceleyin. Bulut kimlikleri ve VPN bağlantıları da paylaşılan hizmet erişimi sağlayabilir. Depo erişimi ve kişisel bağlantılar, görevi çalıştıran hesaba bağlıdır.

Codex'i bulutta kullan izni görev erişimini kontrol eder. Çalışma alanı ortamlarını yönet izni, çalışma alanıyla paylaşılan ortamların oluşturulmasını ve düzenlenmesini kontrol eder. Roller ve çalışma alanı izinleri sayfasına bakın.

Agent Security

Ortamın internet erişimi ayarları, sanal makinesinin hangi alan adlarına erişebileceğini belirler. VPN ayarları, bu sanal makineyi özel bir ağdaki hizmetlere bağlar.

Enterprise çalışma alanlarında yöneticiler, ajan davranışı, yönetilen yürütmenin ağ erişimi ve desteklenen araç kullanımı için çalışma alanı gereksinimlerini Agent Security üzerinden yapılandırır. Bu gereksinimler, her ortamla birlikte kaydedilen alan adı ayarlarıyla birlikte geçerlidir. Genel politikalar ve desteklenen Codex Cloud geçersiz kılmaları için Agent Security sayfasına bakın.

Hizmetlere bağlanın

İş akışınızın ihtiyaç duyduğu paket kayıt hizmetlerine, API'lere ve diğer hizmetlere erişimi yapılandırın:

1. Ortam yapılandırmasında Codex'in internete erişmesine izin ver seçeneğini açın.
2. Alan adlarına izin ver altında Paket yöneticileri veya Yalnızca özel alan adları seçeneğini seçin, ardından İzin verilen ek alan adları altına gerekli ana bilgisayarları ekleyin. İş akışı daha geniş erişim gerektiriyorsa Tümü (kısıtlamasız) seçeneğini kullanın.
3. Kaydedin ve kurulum sırasında hizmetleri test edin. Yayımlayın veya yeniden yayımlayın, ardından yeni bir görevde erişimi doğrulayın.

Çalışma alanı gereksinimleri için Agent Security sayfasına bakın. Bir hedefe izin vermek, kimlik bilgilerini sağlamaz veya o hizmette izin vermez.

Paket yöneticileri ön ayarına dahil olan alan adları

Paket yöneticileri ön ayarı, aşağıdaki kayıt hizmetlerine, depolara ve indirme sunucularına izin verir:

• npm ve Yarn: registry.npmjs.org, registry.yarnpkg.com
• PyPI ve PyTorch: pypi.org, files.pythonhosted.org, download.pytorch.org, download-r2.pytorch.org
• Rust: crates.io, index.crates.io, static.crates.io, static.rust-lang.org
• Go: proxy.golang.org, sum.golang.org
• Maven ve Gradle: repo.maven.apache.org, repo1.maven.org, plugins.gradle.org, plugins-artifacts.gradle.org, services.gradle.org, downloads.gradle.org
• Bazel: bcr.bazel.build, mirror.bazel.build
• Buf: buf.build
• CPAN: cpan.metacpan.org
• Ubuntu ve Debian depoları: archive.ubuntu.com, security.ubuntu.com, ports.ubuntu.com, ppa.launchpadcontent.net, deb.debian.org, security.debian.org
• Sağlayıcı depoları: packages.microsoft.com, apt.buildkite.com, developer.download.nvidia.com, deb.nodesource.com
• GitHub kaynak kodu, arşivler, sürümler ve LFS: github.com, codeload.github.com, github-cloud.githubusercontent.com, github-cloud.s3.amazonaws.com, release-assets.githubusercontent.com
• Diğer indirmeler: dl.google.com, pkgconfig.freedesktop.org

Kayıtlı kök alan adları için Codex, ilgili www ana bilgisayar adına da izin verir. Diğer alt alan adları, izin verilen alan adları listesinde ayrı girdiler gerektirir. Bağımlılıklarınızın gerektirdiği diğer ana bilgisayarları İzin verilen ek alan adları altına ekleyin.

Genel internet üzerinden erişilen ve bağlantıları kaynak IP'ye göre filtreleyen hizmetler için ajan çıkış IP'si akışını kullanın. Yayımlanan tüm aralıklara izin verin, akışı günlük olarak kontrol edin ve aralıklar değiştiğinde hizmetin izin listesini güncelleyin. Bu aralıklar müşteriler arasında paylaşılır; hizmetin kimlik doğrulama ve yetkilendirme denetimlerini koruyun.

Özel ağ bağlantısı (VPN)

Bir VPN bağlantısı üzerinden bulut görevlerinin özel ağınızdaki dahili API'lere, paket kayıt hizmetlerine ve diğer HTTP veya HTTPS hizmetlerine erişmesini sağlayın.

1. Ortamın Gelişmiş > VPN ayarlarını açın ve Ekle seçeneğini seçin.
2. VPN sağlayıcınızın bağlantı kimlik bilgilerini girin.
3. Gerekli hedeflere hem VPN erişim kurallarında hem de ortamın internet erişimi ayarlarında izin verin.
4. Kaydedin, ardından yayımlayın veya yeniden yayımlayın. Yeni bir görev başlatın ve hizmeti test edin.

Şu anda desteklenen VPN sağlayıcısı Tailscale'dir. Tailscale kimlik doğrulama anahtarı oluştururken hem Yeniden kullanılabilir hem de Geçici seçeneklerini etkinleştirin. Yeniden kullanılabilir bir anahtar, yeni bulut görevi sanal makinelerinin ağınıza katılmasını sağlar. Tailscale, geçici cihazları çevrimdışı olduktan sonra otomatik olarak kaldırır. Ek VPN sağlayıcıları için destek planlanmaktadır.

Özel IPv4 alt ağ rotaları desteklenir. Görevler, özel hizmetlere ana makine adıyla erişmek için Tailscale bölünmüş DNS ve MagicDNS özelliklerini kullanabilir.

Hizmetiniz kuruluşunuzun dahili DNS’ini kullanıyorsa dahili alan adınıza yönelik sorguları DNS sunucunuza göndermek için Tailscale yönetim konsolunda bölünmüş DNS’i yapılandırın. Hizmetin tam nitelikli ana makine adını kullanın; örneğin api.corp.example.com. Bu ad bir IPv4 adresine çözümlenmelidir. Hedefe ayrıca ortamın internet erişimi ayarları ve Tailscale erişim kurallarınız kapsamında izin verilmiş olmalıdır.

Paylaşılan bir ortamdaki görevler, ortamın yapılandırılmış VPN kimliğini kullanır.

OIDC ile bulut kaynaklarına erişin

OpenID Connect (OIDC), bir görevin bulut kaynakları için kısa ömürlü kimlik bilgileri almasını sağlar. Kuruluşunuz, bulut sağlayıcısıyla güven ilişkisini yapılandırır ve kimliğe iş akışının ihtiyaç duyduğu izinleri verir.

1. Kaydedilmiş ortamın Gelişmiş > OIDC ayarlarını açın.
2. Ekle seçeneğini seçin, ardından kullanılabilir bir bağlantı veya desteklenen bir sağlayıcı için Bağlantı oluştur… seçeneğini belirleyin.
3. Yeni bir bağlantı için sağlayıcının kimlik ayrıntılarını girin ve bağlantıyı oluşturun. Sağlayıcı tarafında, görüntülenen Düzenleyen, Hedef kitle ve Konu ya da claim koşullarını kullanarak güven ilişkisini yapılandırın ve kaynak izinlerini verin.
4. Bağlantının iliştirildiğini doğrulayın ve takma adını inceleyin. Kaydedin, ardından ortamı yayımlayın veya yeniden yayımlayın.
5. Yeni bir görev başlatın ve izin verilen bir işlemle reddedilen bir işlemi test edin.

Sağlayıcı kurulumu değişiklik gösterir ve yalnızca desteklenen bağlantılar iliştirilebilir. Erişimi kimliğin izinleri belirler; sağlayıcıdaki kişisel izinleriniz bu kimliğe aktarılmaz. Ağ politikasında gerekli sağlayıcı uç noktalarına ve hizmet hedeflerine ayrı ayrı izin verin.

İliştirme veya takma ad değişikliklerini kurulum sırasında uygulamak için kaydedin; yeni görevlerde kullanmak için yayımlayın veya yeniden yayımlayın. Paylaşılan bir kimlik bağlantısını düzenlemek, onu kullanan diğer ortamları etkileyebilir.

OIDC, Enterprise çalışma alanları için talep üzerine kullanılabilir. Etkinleştirmek için OpenAI hesap ekibinizle iletişime geçin.

Bir görevi çalıştırın ve göreve geri dönün

Yayımlanmış bir ortam seçin ve hedefinizi açıklayın. Codex, dosyaları düzenlemek, komutları çalıştırmak ve yaptığı işi kontrol etmek için ortamın depolarını ve araçlarını kullanır. Commit etmeden veya bir pull request açmadan önce değişiklikleri ve test sonuçlarını inceleyin.

Web'de veya mobil cihazda devam edin

Web’de Çalışma yeri > Bulut seçeneğini ve ardından bir ortam seçin. Mobil cihazınızda Codex bölümünü açın ve kullanılabilir bir ortam seçin. Yeni ortamları web’de veya masaüstü uygulamasında oluşturun.

Çalışmaya farklı cihazlarda devam etmek için aynı görevi yeniden açın. Yeni bir görev, yayımlanmış yapılandırmadan ayrı bir çalışma başlatır. Codex Cloud'daki görevler, bilgisayarınız uyku modundayken de çalışmaya devam edebilir.

Slack veya Microsoft Teams üzerinden görev başlatın

Buluta görev devretme özelliğinin etkin olduğu bir Enterprise çalışma alanında, @ChatGPT öğesinden Slack veya Microsoft Teams üzerinden bir depo üzerinde çalışmasını isteyin. Codex, çalışma alanınızla paylaşılan ve görevi çalıştıran hesabın erişebildiği bir ortam seçmek için sohbet bağlamını kullanır. Promptunuzda tercih ettiğiniz bir ortamı belirtebilir veya ek yönlendirmeler sağlayabilirsiniz.

Slack için, Codex Cloud rol tabanlı erişim kontrolünü kullanan çalışma alanları, hem dağıtımın hizmet hesabına hem de istekte bulunan kullanıcıya Codex Cloud erişimi vermelidir. Yönetici kurulumu için Slack için Codex Cloud'u etkinleştirme sayfasına bakın.

Tüm bağlantı ve onay istemlerini tamamlayın, ardından sonucu sohbet içinde inceleyin. Göreve devam etmek için aynı bağlı hesaptan takip mesajı gönderin; başka bir katılımcının isteği görevinizi otomatik olarak devam ettirmez.

Çalışma alanı kurulumu için Slack ve Teams'de ChatGPT'yi yönetme sayfasına, Slack görev denetimleri için Slack'te ChatGPT kullanımı sayfasına bakın.

Sanal makine özellikleri

Her bulut görevi, aşağıdaki varsayılan kaynaklara sahip bir sanal makinede çalışır:

Varsayılan olarak, bir görevin kaydedilmiş sanal makine durumu, en son bir tur başlattığınız veya görevi sürdürdüğünüz andan itibaren yedi güne kadar kurtarılabilir.

Enterprise için daha büyük sanal makineler ve özel yapılandırmalar sunulur. Kullanılabilir yapılandırmalar ve fiyatlandırma için OpenAI hesap ekibinizle iletişime geçin.

Mevcut sınırlamalar

Aşağıdaki özellikler şu anda bulut ortamlarında desteklenmemektedir ve yol haritamızda yer almaktadır:

• Bilgisayar ve tarayıcı kullanımı
• GitLab ve kendi sunucunuzda barındırılan GitHub Enterprise Server

Deponuzda saklanan skill’ler bulut görevlerinde kullanılabilir. Yerel bilgisayarınızdaki kişisel skill’ler bulut ortamlarıyla eşitlenmez.

Kurulum ve çalışma zamanı erişimi sorunlarını giderin

Kurulum başarısız oluyor veya gerekli bir araç eksik

Başarısız olan komutu bulmak için kurulum sohbetini kontrol edin. Codex'ten hatayı teşhis etmesini ve düzelttikten sonra komutu yeniden çalıştırmasını isteyin. Örneğin: "pnpm'i yükle ve projenin testlerini çalıştır."

• İlk kurulum başarısız olursa o kurulum oturumunda zaten seçilmiş depolarla yeniden denemek için Tekrar dene seçeneğini seçin.
• Düzeltme, kaynak dosyalarının, bir paket bildiriminin veya bir kilit dosyasının değiştirilmesini gerektiriyorsa, bu değişikliği bir kodlama görevinde yapın, ardından kuruluma dönün.

Codex kurulumu doğruladıktan sonra ortamı yayımlayın veya yeniden yayımlayın.

Bir paket indirme işlemi veya HTTPS isteği başarısız oluyor

Hedef ana bilgisayar adını ve kimlik doğrulamayı ayrı ayrı kontrol edin:

1. Ana bilgisayara ortamın internet erişimi ayarlarında izin verildiğini doğrulayın. Özel bir paket kayıt hizmeti packages.example.com adresindeyse tam olarak bu ana bilgisayar adını kontrol edin. İndirmeler ayrıca downloads.example.com adresini kullanıyorsa bu ana bilgisayarın da erişime ihtiyacı vardır.
2. Paket yöneticisinin veya istemcinin yapılandırılmış URL'sini ve kimlik bilgilerini kontrol edin. Bir alan adına izin vermek, hizmete erişim yetkisi vermez.
3. Kimlik doğrulamada bir ağ gizli bilgisi kullanılıyorsa İzin verilen alan adları listesinin hedefi içerdiğini ve isteğin 443 numaralı bağlantı noktasında HTTPS kullandığını kontrol edin.
4. Enterprise çalışma alanında, bir yöneticiden geçerli Agent Security gereksinimlerini ortam ayarlarıyla birlikte kontrol etmesini isteyin.

Yapılandırma değişikliklerini kaydedin ve isteği kurulum sırasında test edin. Yayımlayın veya yeniden yayımlayın, ardından yeni bir görevde erişimi doğrulayın.

Gerekli bir değer eksik veya kullanılamıyor

Değeri ortam yapılandırmasında doğru yere eklediğinizi kontrol edin:

• Ortam değişkenleri: bunları, programların doğrudan okuması gereken APP_MODE=development gibi değerler için kullanın.
• Ağ gizli bilgileri: bunları, özel bir paket kayıt hizmeti tokenı gibi izin verilen bir HTTPS hizmetine gönderilen kimlik bilgileri için kullanın. Programlara bir yer tutucu iletilir; proxy, eşleşen isteklerde yer tutucuyu kimlik bilgisiyle değiştirir. Programın ham değeri okuması gerekiyorsa değeri Ortam değişkenleri altına ekleyin.

Kişisel bir değer için Anahtar alanının ortamın isteğiyle eşleştiğini ve Geçerli olduğu ortamlar alanının bu ortamı içerdiğini kontrol edin. Belirli bir ortama ait değer, genel varsayılan değere göre önceliklidir.

Kurulum talimatları için Ortam değişkenleri ve ağ gizli bilgileri sayfasına bakın.

VPN bağlanıyor ancak bir HTTP veya HTTPS hizmetine erişilemiyor

1. İstemcinin ortamda yapılandırılmış HTTP/HTTPS proxy’sini kullandığını doğrulayın. curl ile test ederken isteğin bu proxy’yi kullanması için --noproxy seçeneğini kullanmayın.
2. Hedefi hem ortamın izin verilen alan adlarına hem de VPN erişim kurallarına göre kontrol edin.
3. Hizmete IP adresiyle erişilebiliyor ancak ana makine adıyla erişilemiyorsa Tailscale DNS ayarlarınızı kontrol edin. Dahili bir şirket alan adı için bölünmüş DNS’in doğru DNS sunucusuna yönlendirdiğini ve bu sunucuya Tailscale ağınız üzerinden erişilebildiğini doğrulayın. Hizmetin tam nitelikli ana makine adını kullanın ve bu adın bir IPv4 adresine çözümlendiğini doğrulayın.

Bağlantı kurulumu için Özel ağ bağlantısı sayfasına bakın.

Bir ortam veya güncellemeleri görev için kullanılamıyor

Ayarlar > Codex Cloud > Ortamlar yolundan ortamı kontrol edin. Yayımlanmadı rozeti varsa kurulumu tamamlayın ve görevlerde kullanılabilir hale getirmek için Yayımla seçeneğini seçin.

Yayımlanmış bir ortamda değişiklik yapmak için Düzenle akışını açın, Codex'in değişiklikleri hazırlayıp test etmesini bekleyin, ardından Yeniden yayımla seçeneğini seçin. Yeni yapılandırmayı kullanmak için güncellenmiş ortamdan yeni bir görev başlatın. Mevcut görevler kendi çalışma durumlarını korur.