Skip to main content
Version: Next

Run your first job

This page gives you the shortest path to a successful SeaTunnel run. The example stays fully local, does not require MySQL, Kafka, or object storage, and helps you confirm that your installation, config parsing, and execution engine are all working.

Step 1: Finish local deployment​

Complete Deployment first and make sure bin/seatunnel.sh is available in your SeaTunnel home directory.

Step 2: Install only the plugins this sample needs​

Follow Deployment > Download The Connector Plugins, then keep only connector-fake and connector-console in config/plugin_config:

--seatunnel-connectors--
connector-fake
connector-console
--end--

Install the plugins and confirm they were downloaded into ${SEATUNNEL_HOME}/connectors:

cd "${SEATUNNEL_HOME}"
sh bin/install-plugin.sh
ls connectors | rg 'connector-(fake|console)'

Step 3: Use a minimal job​

Save the following config as config/v2.batch.config.template or another local file:

env {
  parallelism = 1
  job.mode = "BATCH"
}

source {
  FakeSource {
    plugin_output = "fake"
    row.num = 16
    schema = {
      fields {
        name = "string"
        age = "int"
      }
    }
  }
}

transform {
  FieldMapper {
    plugin_input = "fake"
    plugin_output = "fake1"
    field_mapper = {
      age = age
      name = new_name
    }
  }
}

sink {
  Console {
    plugin_input = "fake1"
  }
}

Step 4: Run it in local mode​

cd "apache-seatunnel-${version}"
./bin/seatunnel.sh --config ./config/v2.batch.config.template -m local

Expected validation result​

  • The process starts successfully without connector loading errors.
  • The console prints an output rowType line for the mapped fields.
  • The console prints 16 rows from ConsoleSinkWriter.
  • The batch job exits successfully after all rows are written.

If this works, your basic local path is healthy and you can move on to real pipelines.

Next step​