Referência de dev.nix

Esta página inclui detalhes sobre o esquema do ambiente do espaço de trabalho de configuração do Terraform, que precisa estar sempre em .idx/dev.nix.

Para saber mais sobre a língua nix, consulte a linguagem oficial do Nix tutorial.

pacotes

Pacotes a serem instalados no ambiente.

Use o argumento pkgs para selecionar pacotes a serem instalados, por exemplo pkgs.python3. O conteúdo de pkgs depende do ID Opção de canal channel.

Exemplo:

{pkgs, ...}: {
  channel = "stable-23.11";
  packages = [pkgs.vim];
}

Você pode pesquisar pacotes disponíveis aqui: stable-23.11 ou instável.

Tipo:lista de pacotes

Padrão:[ ]

canal

nixpkgs a ser usado.

Esse canal define o conteúdo do argumento pkgs.

Tipo: "stable-23.05", "stable-23.11", "stable-24.05", "unstable"

Padrão:"stable-23.11"

env

Variáveis de ambiente definidas no ambiente do desenvolvedor.

Elas são propagadas para todos os shells e para o servidor de visualização. Ambiente as variáveis podem ser especialmente úteis se seu aplicativo exigir um conjunto específico de variáveis.

O valor de cada variável pode ser uma string ou uma lista de strings. A último é concatenado, intercalado com caracteres de dois-pontos.

PATH precisa ser uma lista, porque ela está sempre estendida e nunca é completamente substituída.

Exemplo:

{pkgs, ...}: {
  env = {
    HELLO = "world";
    # append an entry to PATH
    PATH = ["/some/path/bin"];
  };
}

Tipo:conjunto de atributos de (lista de strings) ou qualquer item

Padrão:{ }

idx.extensions

As extensões de código que você quer instalar no espaço de trabalho do IDX.

Esta é uma lista de IDs de extensão totalmente qualificados, por exemplo ${publisherId}.${extensionId}:

Você pode encontrar uma lista de extensões disponíveis na Abra o VSX Registry e insira as informações no arquivo dev.nix por ${publisherId}.${extensionId}.

Tipo:lista de (caminho ou string não vazia)

Padrão:[ ]

idx.previews.enable

Defina como true para ativar as visualizações do IDX.

Com esse recurso, é possível executar e atualizar seus apps automaticamente desenvolvê-las.

Tipo: booleano

Padrão:true

Exemplo: true.

idx.previews.previews

Configurações de visualização.

Defina os comandos que o IDX executa no seu ambiente de desenvolvedor.

Exemplo:

{pkgs, ...}: {
  idx.previews = {
    enable = true;
    previews = {
      web = {
        command = ["yes"];
        cwd = "subfolder";
        manager = "web";
        env = {
          HELLO = "world";
        };
      };
    };
  };
}

Tipo: conjunto de atributos de (submódulo)

Padrão:{ }

idx.previews.previews.<name>.activity

Atividade de inicialização do Android

Tipo: string

Padrão:""

idx.previews.previews.<name>.command

Comando a ser executado

Tipo:lista de strings

Padrão:[ ]

idx.previews.previews.<name>.cwd

Diretório de trabalho

Tipo: string

Padrão:""

idx.previews.previews.<name>.env

Variáveis de ambiente a serem definidas.

Tipo: conjunto de atributos de strings

Padrão:{ }

idx.previews.previews.<name>.manager

Gerente

Tipo: "Web", "flutter", "android", "gradle"

idx.workspace.onCreate

Comandos a serem executados quando o espaço de trabalho é criado e aberto pela primeira vez.

Isso pode ser útil para configurar o ambiente de desenvolvimento. Por exemplo, aqui estão especificando npm install para serem executados:

{pkgs, ...}: {
  idx.workspace.onCreate = {
    npm-install = "npm install";
    # files to open when the workspace is first opened.
    default.openFiles = [ "src/index.ts" ];
  };
}

Tipo: conjunto de atributos de (path ou string ou ({ openFiles = [ string ];}))

Padrão:{ }

idx.workspace.onStart

Comandos a serem executados sempre que o espaço de trabalho é aberto.

Isso pode ser útil para começar a criar observadores. Por exemplo, aqui estamos especificando Dois comandos a serem executados:

{pkgs, ...}: {
  idx.workspace.onStart = {
    npm-watch-fe = "npm run watch:frontend";
    npm-watch-be = "npm run watch:backend";
    # files to open when the workspace is (re)opened.
    default.openFiles = [ "src/index.ts" ];
  };
}

Tipo: conjunto de atributos de (path ou string ou ({ openFiles = [ string ];}))

Padrão:{ }

services.docker.enable

Define se o Docker sem raiz será ativado.

Tipo: booleano

Padrão:false

Exemplo: true.

services.mongodb.enable

Define se o servidor MongoDB será ativado.

Tipo: booleano

Padrão:false

Exemplo: true.

services.mongodb.package

Pacote MongoDB a ser usado.

Tipo: pacote

Padrão:<derivation mongodb-6.0.11>

services.mongodb.port

Configura a porta que o Mongod vai ouvir.

Por padrão, o tcp está desativado e o Mongod detecta apenas em /tmp/mongodb/mongodb.sock. Para conectar, use a string de conexão “mongodb://%2Ftmp%2Fmongodb%2Fmongodb.sock”

Tipo: número inteiro não assinado de 16 bits. entre 0 e 65.535 (ambos inclusive)

Padrão:0

services.mysql.enable

Define se o servidor MySQL será ativado.

O servidor é inicializado com uma raiz de usuário sem senha. Então, para criar usuários e criar bancos de dados usam mysql -u root. .

Tipo: booleano

Padrão:false

Exemplo: true.

services.mysql.package

o pacote MySQL a ser usado.

Tipo: pacote

Padrão:pkgs.mysql

Exemplo: pkgs.mysql80.

services.postgres.enable

Define se o servidor PostgreSQL será ativado.

Tipo: booleano

Padrão:false

Exemplo: true.

services.postgres.enableTcp

Define se o Postgres deve detectar no TCP.

Tipo: booleano

Padrão:true

Exemplo: true.

services.postgres.package

o pacote PostgreSQL a ser usado.

Tipo: pacote

Padrão:pkgs.postgresql

Exemplo: pkgs.postgresql_15.

services.postgres.extensions

Extensões Postgres para instalar.

Tipo:lista de (uma de "idade", "apache_datasketches", "cstore_fdw", "hypopg", "jsonb_deep_sum", "periods", "pg_auto_failover", "pg_bigm", "pg_cron", "pg_ed25519", "pg_embedding", "pg_hint_plan", "pg_hll", "pg_ivm", "pg_net", "pg_partman", "pg_rational", "pg_relusage", "pg_repack", "pg_safeupdate", "pg_similarity", "pg_topn", "pg_uuidv7", "pgaudit", "pgjwt", "pgroonga", "pgrouting", "pgsql-http", "pgtap", "pgvector", "plpgsql_check", "plr", "plv8", "postgis", "promscale_extension", "repmgr", "rum", "smlar", "tds_fdw", "temporal_tables", "timescaledb", "timescaledb-apache", "timescaledb_toolkit", "tsearch_extras", "tsja", "wal2json")

Padrão:[ ]

Exemplo: [ "pgvector" "postgis" ];.

services.pubsub.enable

Define se o emulador do Google Pub/Sub será ativado.

Mais documentação sobre como usar o emulador pode ser encontrada aqui: https://cloud.google.com/pubsub/docs/emulator#using_the_emulator .

Tipo: booleano

Padrão:false

Exemplo: true.

services.pubsub.port

Configura a porta que o Pub/Sub vai detectar.

Tipo: número inteiro não assinado de 16 bits. entre 0 e 65.535 (ambos inclusive)

Padrão:8085

services.pubsub.project-id

ID do projeto a ser usado para executar o emulador do Pub/Sub. Este projeto é apenas para testes, ele não precisa existir e é usado apenas localmente.

Tipo: string que corresponde ao padrão [a-z][a-z0-9-]{5,29}

Padrão:"idx-pubsub-emulator"

services.redis.enable

Define se o servidor Redis será ativado.

Tipo: booleano

Padrão:false

Exemplo: true.

services.redis.port

Configura a porta que o Redis vai detectar.

Por padrão, o tcp está desativado e o redis detecta apenas em /tmp/redis/redis.sock.

Tipo: número inteiro não assinado de 16 bits. entre 0 e 65.535 (ambos inclusive)

Padrão:0

services.spanner.enable

Define se o emulador do Google Cloud Spanner será ativado.

Tipo: booleano

Padrão:false

Exemplo: true.

services.spanner.fault-injection

Define se a injeção de falhas aleatórias em transações será ativada.

Tipo: booleano

Padrão:false

Exemplo: true.

services.spanner.grpc-port

A porta TCP a que o emulador precisa estar vinculado.

Tipo: número inteiro não assinado de 16 bits. entre 0 e 65.535 (ambos inclusive)

Padrão:9010

services.spanner.rest-port

A porta em que as solicitações REST são disponibilizadas

Tipo: número inteiro não assinado de 16 bits. entre 0 e 65.535 (ambos inclusive)

Padrão:9020