XLA geliştirici kılavuzu

Bu kılavuzda, XLA projesini geliştirmeye nasıl başlayacağınız gösterilmektedir.

Başlamadan önce aşağıdaki ön koşulları tamamlayın:

  1. CONTRIBUTING.md adresine gidip katkı sürecini inceleyin.
  2. Henüz yapmadıysanız Katkıda Bulunan Lisans Sözleşmesi'ni imzalayın.
  3. Aşağıdaki bağımlılıkları yükleyin veya yapılandırın:

Ardından kaynak kodunu almak, ortam kurmak, depoyu derlemek ve bir pull isteği oluşturmak için aşağıdaki adımları uygulayın.

Kodu alın

  1. XLA deposunun bir çatalını oluşturun.

  2. <USER> kısmını GitHub kullanıcı adınızla değiştirerek deponun çatalını klonlayın:

    git clone <a href="https://github.com/">https://github.com/</a><USER>/xla.git

  3. xla dizinine geçin: cd xla

  4. Uzak yukarı akış deposunu yapılandırın:

    git remote add upstream <a href="https://github.com/openxla/xla.git">https://github.com/openxla/xla.git</a>

Ortam ayarlama

  1. Bazel'i yükleyin.

    XLA'yı oluşturmak için Bazel yüklü olmalıdır. Bazel'ı yüklemek için önerilen yol, XLA için doğru Bazel sürümünü otomatik olarak indiren Bazelisk'i kullanmaktır. Bazelisk kullanılamıyorsa Bazel'ı manuel olarak yükleyebilirsiniz.

  2. TensorFlow Docker container'ı oluşturun ve çalıştırın.

    CPU için TensorFlow Docker görüntüsünü almak üzere aşağıdaki komutu çalıştırın:

    docker run --name xla -w /xla -it -d --rm -v $PWD:/xla tensorflow/build:latest-python3.9 bash

    Alternatif olarak, GPU için TensorFlow Docker görüntüsünü almak üzere aşağıdaki komutu çalıştırın:

    docker run --name xla_gpu -w /xla -it -d --rm -v $PWD:/xla tensorflow/tensorflow:devel-gpu bash

Topluluk

CPU için derleme:

docker exec xla ./configure
docker exec xla bazel build --test_output=all --spawn_strategy=sandboxed //xla/...

GPU'ya göre derleme:

docker exec -e TF_NEED_CUDA=1 xla_gpu ./configure
docker exec xla_gpu bazel build --test_output=all --spawn_strategy=sandboxed //xla/...

İlk derlemeniz uzun sürer çünkü bunun XLA, MLIR ve StableHLO da dahil olmak üzere tüm yığını derlemesi gerekir.

XLA oluşturma hakkında daha fazla bilgi için Kaynaktan derleme konusuna bakın.

Pull isteği oluşturma

Değişiklikleri incelemeye göndermeye hazır olduğunuzda alma isteği oluşturun.

XLA kod inceleme felsefesi hakkında bilgi edinmek için Kod incelemeleri konusuna bakın.