Skip to content

Commit 8195705

Browse files
committed
Add known_issue to documentation
1 parent 05e4e29 commit 8195705

File tree

1 file changed

+22
-1
lines changed

1 file changed

+22
-1
lines changed

docs/pdk_known_issues.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,26 @@
11
# PDK known issues
22

3+
## PDK 3.4.0 - Issue with utilising bundled templates
4+
5+
We have recently begun seeing an issue with the default bundled templates on certain OSs, with the pdk failing to see them as valid as shown in the below error.
6+
7+
```
8+
pdk (FATAL): Unable to find a valid module template to use.
9+
```
10+
11+
Through investigation this seems most likely to be an issue with a dependency brought in throught Git and unfortunately one that we have not been able to resolve in time for this release.
12+
13+
This error is most commonly found when creating a new module or attempting to update a module that was previously created from the default templates, within an airgapped environment.
14+
15+
There is a relatively simple solution to get around this however, though it does require a few extra steps and that is to clone down the pdk-template repo onto your machine and target it manually as shown below.
16+
17+
```
18+
pdk new module example --template-url=file:///Users/example.user/Github/pdk-templates --template-ref=3.4.0
19+
pdk update --template-url=file:///Users/example.user/Github/pdk-templates --template-ref=3.4.0
20+
```
21+
22+
Once the first run has been made, the PDK will store your targeted templates location and so your next run should automatically go to it moving forward, until such time as you target another or clear your .pdk cache.
23+
324
## PDK v3.3.0 requires puppet-modulebuilder
425

526
With the v3.3.0 release of the PDK, it has been updated to utilise the [puppet-modulebuilder](https://github.com/puppetlabs/puppet-modulebuilder) with the previously existing duplicated internal code having been removed. As such anyone who uses `PDK::Module::Build` in their setup will need to update their own code to do the same.
@@ -14,4 +35,4 @@ For more information on how to correct this known issue see the [PDK Troubleshoo
1435

1536
## PDK v3.0.1 Cert expired
1637

17-
This issue was resolved and shipped in PDK v3.1.0, if you are seeing an issue in relation to an expired cert, please upgrade the PDK.
38+
This issue was resolved and shipped in PDK v3.1.0, if you are seeing an issue in relation to an expired cert, please upgrade the PDK.

0 commit comments

Comments
 (0)