Åpne appen

DokumentasjonWorkflowsApper og tjenester

GitHub-filer og branches node

Leser og skriver filer, branches og commits i et repository, f.eks. «Hva står det i README-en på main?» eller lagre en fil med en commit. Se oppsett, input og output, testkjøring og løsning av vanlige feil.

10 min lesetidOppdatert

Hva noden gjør

Leser og skriver filer, branches og commits i et repository, f.eks. «Hva står det i README-en på main?» eller lagre en fil med en commit.

Bruk GitHub-filer og branches som et tydelig avgrenset trinn i en anymize-workflow.

  • Behandler 1 input.
  • Gir 1 output til senere trinn.
  • Kjører som et vanlig trinn i flyten.

Sett opp noden

  1. 01Åpne en workflow og legg til GitHub-filer og branches fra nodekatalogen.
  2. 02Hvis GitHub-kontoen din ikke er koblet til ennå, kobler du den til direkte i nodepanelet eller under Koblinger.
  3. 03Fyll ut obligatoriske felt og koble verdier fra tidligere trinn.
  4. 04Kjør noden med et lite testdatasett og kontroller outputtet.
  5. 05Koble det vellykkede outputtet og aktiver etter en fullstendig test.

Handlinger og moduser

Velg ønsket funksjon i Handling. Panelet viser deretter de relevante innstillingene.

  • List opp branches
  • List opp commits
  • Les fil
  • Les branch
  • Opprett branch
  • Slett branch
  • Les commit
  • Sammenlign versjoner
  • Les README
  • Lagre fil
  • Slett fil
  • Søk i kode
  • List opp tags

Innstillinger

FeltBetydningOmråde
HandlingValg: List opp branches, List opp commits, Les fil, Les branch, Opprett branch, Slett branch, Les commit, Sammenlign versjoner, Les README, Lagre fil, Slett fil, Søk i kode, List opp tagsStandard
Eier (bruker eller org)GitHub-navnet som eier repoet, f.eks. anymize.Standard
RepositoryNavnet på repositoryet, f.eks. hello-world.Standard
Bare beskyttede branchesKonfigurer verdien i nodepanelet.Standard
Antall (maks 100)Hvor mange oppføringer som hentes per kall. Uten virkning med «Hent alle sider», da er det alltid 100 per side.Standard
Hent alle siderHenter flere sider til alt er med, maks 1000 oppføringer.Standard
SideHvilken side hentingen starter på, f.eks. neste side fra forrige kall. Tomt: den første. Uten virkning med «Hent alle sider».Standard
BranchHvilken branch, f.eks. main.Standard
FilstiSti i repositoryet, f.eks. src/index.ts eller README.md.Standard
Fra personGitHub-navn eller e-post.Standard
Endret sidenBare oppføringer som er endret siden dette tidspunktet, f.eks. 2026-01-31T00:00:00Z.Standard
Endret tilKonfigurer verdien i nodepanelet.Standard
Versjon (branch)Hvilken branch det leses fra, f.eks. main. Proffer kan oppgi en commit-hash.Standard
Ny branchKonfigurer verdien i nodepanelet.Standard
UtgangspunktBranch, tag eller commit det skal forgrenes fra. Tomt: standardbranchen.Standard
Commit eller branchKonfigurer verdien i nodepanelet.Standard
FraEldre versjon, branch eller commit.Standard
TilNyere versjon, branch eller commit.Standard
InnholdDet nye innholdet i filen.Standard
Innholdet foreligger somValg: Tekst, Base64Standard
Commit-meldingKort om hva som ble endret.Standard
Forrige filversjonBare for proffer. Tomt: hentes automatisk.Standard
SøkeordDu trenger et søkeord. Proffer kan bruke filtre, f.eks. repo:octocat/hello-world.Standard
GitHub-kontoLa feltet stå tomt, så bruker trinnet den tilkoblede GitHub-kontoen din.Standard
Kjør én gang per elementAv (standard): noden kjører én gang for hele inputet. På: får den flere elementer (for eksempel fra «Del opp liste»), kjører den én gang PER element, og {{ $json }} er da nettopp dette elementet. Slik jobber du deg gjennom en filliste post for post.Standard
Hvis et element feiler«Hopp over» skriver et `error`-felt for elementet som feilet og fortsetter med resten, i stedet for å miste hele kjøringen på én uleselig fil.Standard
Pause mellom elementer (millisekunder)Ventetid før hver kjøring bortsett fra den første. 1000 = 1 sekund per element. Nyttig hvis motparten ellers struper deg. Maksimalt 300000 (5 minutter).Standard

Input og output

InputBetydningType
StandardMottar hele resultatet fra forrige trinn.JSON
OutputBetydningType
StandardGjør resultatet tilgjengelig som JSON for neste trinn.JSON

Noden kan behandle lister element for element. Feilhåndtering og pause finnes under avanserte innstillinger.

Eksempel og testkjøring

Les README fra default-branchen: start med et lite og gjenkjennelig datasett. Kontroller outputtet og bruk bare felt som faktisk finnes.

Eksempel på testkjøring

{
  "owner": "octocat",
  "repo": "hello-world",
  "path": "README.md"
}

Tilgang og sikkerhet

Noden jobber med din egen tilkoblede GitHub-konto. Den ser og endrer bare det kontoen har lov til. Sjekk tillatelsene som vises når du kobler til. Det tilhørende området (Issues, Pull requests, Repos) må også være slått på i innstillingene for GitHub-tilkoblingen din under Koblinger. Som standard er alle områdene slått på.

«Tillatte handlinger» i innstillingene for GitHub-tilkoblingen din under Koblinger gjelder også for noden og kontrolleres ved hver kjøring. Med «Bare lesing» eller «Lesing og utkast» kjører bare de lesende handlingene: List opp branches, List opp commits, Les fil, Les branch, Les commit, Sammenlign versjoner, Les README, Søk i kode, List opp tags. Disse handlingene krever «Tillat endringer»: Opprett branch, Slett branch, Lagre fil, Slett fil.

Nøkler og påloggingsdata hører hjemme i Workflow-secrets eller i de tilkoblede kontoene dine. Ikke lim dem inn som vanlig tekst i workflow-felt, testdata eller beskrivelser.

Løs vanlige feil

  • Ingen output: kontroller siste kjøring og feltene fra forrige node.
  • Tom variabel: åpne outputtet fra forrige trinn og bruk et felt fra de faktiske testdataene.
  • Tilkobling avvist: koble til tjenesten på nytt med nødvendige tillatelser.
  • Handling blokkert: sett «Tillatte handlinger» for tilkoblingen under Koblinger til «Tillat endringer», eller velg en lesende handling.
  • Listen behandles bare én gang: aktiver kjøring per element.

Relaterte artikler