databricks-cli/libs/template/templates/default-python/template/{{.project_name}}
Lennart Kats (databricks) f9e521b43e
databricks bundle init template v2: optional stubs, DLT support (#700)
## Changes

This follows up on https://github.com/databricks/cli/pull/686. This PR
makes our stubs optional + it adds DLT stubs:

```
$ databricks bundle init
Template to use [default-python]: default-python
Unique name for this project [my_project]: my_project
Include a stub (sample) notebook in 'my_project/src' [yes]: yes
Include a stub (sample) DLT pipeline in 'my_project/src' [yes]: yes
Include a stub (sample) Python package 'my_project/src' [yes]: yes
 Successfully initialized template
```

## Tests
Manual testing, matrix tests.

---------

Co-authored-by: Andrew Nester <andrew.nester@databricks.com>
Co-authored-by: PaulCornellDB <paul.cornell@databricks.com>
Co-authored-by: Pieter Noordhuis <pieter.noordhuis@databricks.com>
2023-09-06 09:52:31 +00:00
..
.vscode databricks bundle init template v1 (#686) 2023-09-05 11:58:34 +00:00
fixtures databricks bundle init template v1 (#686) 2023-09-05 11:58:34 +00:00
resources databricks bundle init template v2: optional stubs, DLT support (#700) 2023-09-06 09:52:31 +00:00
scratch databricks bundle init template v2: optional stubs, DLT support (#700) 2023-09-06 09:52:31 +00:00
src databricks bundle init template v2: optional stubs, DLT support (#700) 2023-09-06 09:52:31 +00:00
tests databricks bundle init template v2: optional stubs, DLT support (#700) 2023-09-06 09:52:31 +00:00
.gitignore databricks bundle init template v1 (#686) 2023-09-05 11:58:34 +00:00
README.md.tmpl databricks bundle init template v2: optional stubs, DLT support (#700) 2023-09-06 09:52:31 +00:00
databricks.yml.tmpl databricks bundle init template v1 (#686) 2023-09-05 11:58:34 +00:00
pytest.ini databricks bundle init template v1 (#686) 2023-09-05 11:58:34 +00:00
setup.py.tmpl databricks bundle init template v1 (#686) 2023-09-05 11:58:34 +00:00

README.md.tmpl

# {{.project_name}}

The '{{.project_name}}' project was generated by using the default-python template.

## Getting started

1. Install the Databricks CLI from https://docs.databricks.com/dev-tools/cli/databricks-cli.html

2. Authenticate to your Databricks workspace:
    ```
    $ databricks configure
    ```

3. To deploy a development copy of this project, type:
    ```
    $ databricks bundle deploy --target dev
    ```
    (Note that "dev" is the default target, so the `--target` parameter
    is optional here.)

    This deploys everything that's defined for this project.
    For example, the default template would deploy a job called
    `[dev yourname] {{.project_name}}-job` to your workspace.
    You can find that job by opening your workpace and clicking on **Workflows**.

4. Similarly, to deploy a production copy, type:
   ```
   $ databricks bundle deploy --target prod
   ```

5. To run a job or pipeline, use the "run" comand:
   ```
   $ databricks bundle run {{.project_name}}_job
   ```

6. Optionally, install developer tools such as the Databricks extension for Visual Studio Code from
   https://docs.databricks.com/dev-tools/vscode-ext.html.
{{- if (eq .include_python "yes") }} Or read the "getting started" documentation for
   **Databricks Connect** for instructions on running the included Python code from a different IDE.
{{- end}}

7. For documentation on the Databricks asset bundles format used
   for this project, and for CI/CD configuration, see
   https://docs.databricks.com/dev-tools/bundles/index.html.