Out-of-repo deployment doesn't work for me

[cormullion]

I'm trying to move https://github.com/JuliaGraphics/Luxor.jl docs to https://github.com/JuliaGraphics/LuxorManual. I followed the instructions in the Documenter docs here.

The two keys were added to the correct locations, as far as I can tell, and the make.jl was updated with this:

repo = "github.com/JuliaGraphics/LuxorManual.git"
withenv("GITHUB_REPOSITORY" => repo) do
    deploydocs(
      repo = repo,
      target = "build",
      push_preview = true,
      forcepush = true,
    )
end

The error message here says:

fatal: repository 'https://github.com/github.com/JuliaGraphics/LuxorManual.git.git/' not found

so it's possible the make.jl code I added is wrong, but not sure how...?

[goerz]

Remove the ".git" in repo?

[cormullion]

Thank! Yes, the path looks better now, but although this link looks valid

https://github.com/JuliaGraphics/Luxor.jl/actions/runs/7544837907/job/20539088958#step:7:508

there's still an access error. Perhaps the secret keys aren't correctly set.

[goerz]

Yeah, that looks like the secrets aren’t set up right in the two repositories

[cormullion]

I’ll try and do them again tomorrow. It’s by far the worst aspect of working with Julia… 😂

[goerz]

I'd try deleting all keys and secrets from both repos and start from scratch with DocumenterTools.genkeys

[cormullion]

I did the process again:

Error is:

remote: Permission to JuliaGraphics/LuxorManual.git denied to github-actions[bot].
[507](https://github.com/JuliaGraphics/Luxor.jl/actions/runs/7544837907/job/20564991449#step:7:508)
fatal: unable to access 'https://github.com/JuliaGraphics/LuxorManual.git/': The requested URL returned error: 403
[508](https://github.com/JuliaGraphics/Luxor.jl/actions/runs/7544837907/job/20564991449#step:7:509)
┌ Error: Failed to push:
[509](https://github.com/JuliaGraphics/Luxor.jl/actions/runs/7544837907/job/20564991449#step:7:510)
│   exception =
[510](https://github.com/JuliaGraphics/Luxor.jl/actions/runs/7544837907/job/20564991449#step:7:511)
│    failed process: Process(setenv(`/home/runner/.julia/artifacts/5d776960702ec06ebaac2a94fd96a1c44e8cb04a/bin/git push -fq upstream HEAD:gh-pages`,

make.jl code is:

repo = "JuliaGraphics/LuxorManual"
withenv("GITHUB_REPOSITORY" => repo) do
    deploydocs(
      repo = repo,
      target = "build",
      push_preview = true,
      forcepush = true,
    )
end

So I think the documented procedure isn't working ... ?

[cormullion]

@mortenpi Does my screenshot above look correct? It’s my best guess based on the current documentation…

[mortenpi]

Don't think you have DOCUMENTER_KEY set up right, since it's trying to use GITHUB_TOKEN: https://github.com/JuliaGraphics/Luxor.jl/actions/runs/7544837907/job/20539088958#step:7:133 (also #2165).

Any reason you're trying to configure an environment, rather than just setting up a global secret? I assume the workflow just doesn't have access to the environment.. I think you have to explicitly tell a workflow to use an environment.

• https://docs.github.com/en/actions/deployment/about-deployments/deploying-with-github-actions
• https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment

[cormullion]

Any reason you're trying to configure an environment

I have no idea 😀I think the output of generate_keys said to create an environment variable so I added it. Did I add it to the wrong place?

[goerz]

Should be in "Secrets and variables"

[cormullion]

Should be in "Secrets and variables"

Thanks... I'm obviously the only one to be confused by this but I don't get it at all :(

The Secrets tab has 3 secrets panels - the Documenter docs say "Add the DOCUMENTER_KEY secret to the "source" repository". The genkeys() text says "add a secure environment variable" and the Variables tab has 3 variables panels...

rather than just setting up a global secret?

I can't see any 'global secrets? Just 'Environment Secrets', 'Repository Secrets' and 'Organisation Secrets'.

I'll try copying "the secure environment variable named 'DOCUMENTER_KEY'" to the "Actions secrets and variables/Environment secrets" panel and see if that works.

Thanks for the help though! :)

[goerz]

I'm confused about this myself. I have the impression that the Github UI is somewhat redundant: the same "secrets" are accessible in multiple places, as far as I can tell. They've also changed the UI over the last year or so. At some point, we should change genkeys to give less ambiguous instructions.

But basically, the SSH key goes into Security > Deploy Keys

And the DOCUMENTER_KEY variable goes into Secrets and Variables > Actions > Repository Secrets

Those screenshots are from a standard setup where the documentation is deployed to the same repository. I guess for out-of-repo deployment those two settings are just in different repositories, but otherwise it's the same. I haven't set up out-of-repo deployment myself, though.

[cormullion]

Thanks, @goerz - the pictures are worth a thousand words. I think I have set the keys and secrets correctly now. As you say I think Github must have changed the UI recently...

The error now is :

ssh: Could not resolve hostname juliagraphics: Temporary failure in name resolution
fatal: Could not read from remote repository.

so I'll try again later this weekend to see if this "temporary failure" really is temporary, or is the next obstacle for me.

[goerz]

The line repo = "JuliaGraphics/LuxorManual" in your make.jl is wrong: that should probably be repo = "github.com/JuliaGraphics/LuxorManual.git", according to the documentation.

[cormullion]

Thanks! I’ll try that again (it didn’t work before, but perhaps it will work better with the new secrets…).

[cormullion]

It finally works. Thanks for your help!

[goerz]

My pleasure! It's the least I can do as a small Thank You for JuliaMono!